企业官网建设流程全解析

• 后端
• 即时通讯
• 社交
• 游戏开发

pgx 是 Nakama 游戏后端所依赖的 PostgreSQL 驱动库（当前仓库锁定版本 v5.11.0，见 go.mod），其 v5 系列自 2022 年 9 月发布以来经历了从架构重构到连接字符串解析重写、从协议 3.2 支持到多轮安全加固的持续演进。本文以仓库内 vendor/github.com/jackc/pgx/v5/CHANGELOG.md 为核心骨架，结合 Nakama 服务端对 pgx 的实际调用方式（见 server/db.go），系统梳理 pgx v5 各版本的关键能力、破坏性变更与安全修复，帮助读者理解驱动底层行为，并为升级与排障提供可落地的依据。

一、Nakama 与 pgx：驱动在项目中的实际集成方式

在讨论版本演进之前，先厘清 pgx 在 Nakama 中扮演的角色。从 server/db.go 的源码结构看，Nakama 对 pgx 的使用非常典型，涵盖连接配置、连接池、事务与错误处理多个层面：

• 连接配置：DbConfig将 Nakama 配置中的数据库地址规范化为postgres://URI（不足前缀时自动补全），默认补充sslmode=prefer，默认用户root、默认数据库nakama，最终通过pgx.ParseConfig生成*pgx.ConnConfig（见 server/db.go#L42-L69）。
• 连接与池管理：通过stdlib.OpenDB(connConfig)创建*sql.DB，再设置SetConnMaxLifetime、SetMaxOpenConns、SetMaxIdleConns（见 server/db.go#L122-L135），并周期性用connConfig.LookupFunc做 DNS 地址重解析、在地址变化时排空连接池轮换连接（见 server/db.go#L150-L238）。
• 事务抽象：ExecuteInTxPgx/executeInTxPostgresPgx直接以pgx.Tx与pgx.TxOptions为接口，针对 CockroachDB 走executeInTxCockroachPgx分支（见 server/db.go#L408-L476）。
• 类型系统：核心账号逻辑大量使用pgtype.Timestamptz、pgtype.FlatArray[string]、pgtype.NewMap()（见 server/core_account.go），用于扫描timestamp与字符串数组列。
• 错误分类：通过errors.AsType[*pgconn.PgError]判断数据库错误码，并引用pgerrcode.SerializationFailure等常量处理序列化冲突重试（见 server/api_account.go、server/console_user_reset_password_acl_test.go）。

理解了这一集成面，后续版本变更对 Nakama 的影响就非常直观：连接字符串解析、TLS 行为、日期时间扫描、消息体长度限制等任何底层变化，都会传导到上述代码路径。

二、v5.0 架构重构：Codec/Value 拆分与查询执行模式统一

pgx v5.0.0（2022-09-17）是一次根本性重构，也是理解后续所有版本的基础。CHANGELOG 中记录了以下核心变化：

1. 包合并

github.com/jackc/pgtype、github.com/jackc/pgconn、github.com/jackc/pgproto3全部并入主仓库，消除了多仓库发版不同步、issue 分散的问题。这也是当前仓库 vendor 目录下 vendor/github.com/jackc/pgx/v5 内部同时存在pgconn/、pgtype/、pgproto3/、pgxpool/、stdlib/的原因。

2. pgtype：NULL 表示与 Codec/Value 分离

• 类型的Status字段（Undefined/Null/Present）被替换为Valid bool，与database/sql的 NULL 语义对齐，并使零值可直接使用；所有 nil（无论 typed 还是 untyped）统一表示 NULL。
• Codec 与 Value 拆分：解码/编码职责从值对象中剥离，Codec只负责编解码，值类型通过实现接口（如PointScanner/PointValuer）被 Codec 识别。这一设计解决了"PostgreSQL binarynumeric扫描进 Gofloat64"这类非 1:1 映射的难题。
• 数组与范围类型：所有数组类型统一由ArrayCodec处理（不再逐类型代码生成），Array[T]支持多维数组；范围类型由RangeCodec+Range[T]、多值范围由MultirangeCodec+Multirange[T]处理，用户自定义范围类型因此变得容易。
• Bytea 拆分：原Bytea/GenericBinary被替换为四种选择：[]byte（常规）、DriverBytes（复用驱动内存、免拷贝免分配）、PreallocBytes（预分配切片）、UndecodedBytes（完全不解码、直接接触原始字节）。
• 类型改名：pgtype.ConnInfo→pgtype.Map，pgtype.DataType→pgtype.Type，pgtype.None→pgtype.Finite；Bit/Varbit→Bits；CID/OID/OIDValue/XID→Uint32；Hstore定义为map[string]*string；JSON/JSONB类型移除（直接用[]byte或string）；Inet/Cidr改用netip.Addr/netip.Prefix，Macaddr改用net.HardwareAddr。
• 数字类型字段带位宽：Int2/Int4/Int8/Float4/Float8/Uint32的字段（如Int→Int64）与database/sql约定对齐，pgtype.Int8与sql.NullInt64结构完全一致、可直接互转。
• 与 shopspring/decimal、gofrs/uuid 的集成被抽离到独立仓库，精简了依赖树。

3. 查询执行模式（QueryExecMode）与命名参数

自动预处理语句缓存与 simple 协议的使用被统一为查询执行模式QueryExecMode。NamedArgs通过新的QueryRewriter接口实现对 SQL 与参数的任意重写——这是后来 CHANGELOG 反复提及"simple 协议占位符注入"修复的架构背景。

4. 行扫描与批量查询的新范式

• RowScanner接口允许单个参数扫描整行；CollectRows+RowTo*系列函数、CollectOneRow、ForEachRow（替代QueryFunc）简化结果收集。
• 批处理人体工学改进：Queue返回QueuedQuery，其Query/QueryRow/Exec可注册结果回调，在BatchResults.Close时自动调用，解决了"构建批处理与读取结果两处代码难以对应"的老问题。
• SendBatch 智能使用 pipeline 模式：10 个唯一参数化语句执行 100 次，旧实现需 11 次网络往返（每个 prepare/describe 各 1 次 + 执行 1 次），pipeline 模式将 prepare/describe 合并为一次往返，总计仅 2 次往返。
• 日志被替换为追踪钩子：tracelog提供对 v4 logger 的适配器，支持接入 OpenTelemetry 等自定义追踪；第三方 logger 集成全部外置。

5. 其他值得注意的变化

• CommandTag变为不透明类型；ResultReader.Values()在调用NextRow()/Close()后不可再持有引用。
• pgconn 全面改用非阻塞 IO（v5.4.0 又改回 goroutine + deadline 方案），CheckConn()通过非阻塞读检查连接活性，可发现数据库重启/网络中断而不必执行查询。
• 连接读缓冲区的内存所有权归属驱动，需要保留的值必须显式拷贝，避免小块值钉住大块内存。

三、v5.11.0（2026-09-07）：连接串解析对齐 libpq 与日期时间重写

这是当前仓库锁定的版本（go.mod），也是行为变化最密集的一次发布，升级前必须评估对存量连接串与日期时间处理的影响。

新特性

• Go 1.27 原生类型扫描：stdlib 支持driver.RowsColumnScanner，数组、范围等 PostgreSQL 类型可直接扫描进 Go 值，无需pgtype.Map.SQLScanner；最小 Go 版本仍为 1.25。
• Rows.TypeMap：暴露解码行所用的类型映射，包括由RowsFromResultReader创建、无底层Conn的行；自定义Rows实现（含 mock）必须新增该方法。
• Config.MaxProtocolMessageBodyLen：可配置最大入站协议消息体大小（由 carter-ya 贡献）。
• 只读/主备哨兵错误：新增ErrReadOnlyConnection、ErrReadWriteConnection、ErrPrimaryConnection、ErrStandbyConnection，供target_session_attrs校验使用errors.Is判断。
• pgxpool 的pool_ping_timeout：可在连接串中配置Config.PingTimeout；默认值为零，零与负值表示不设超时。

行为变化一：libpq 兼容的 URI 解析器

pgconn 的postgres://...URI 解析不再使用net/url，改为与 libpq 精确对齐的新解析器（通过与 libpq 本身的差分模糊测试验证）。边缘行为变化包括：

与 libpq 的差异保留：未识别的 URI 查询参数仍被接受（转为运行时参数或 pgx 专属选项）；解析错误消息不回显未经脱敏的连接串，并对可识别的密码字段尽力脱敏（畸形输入结构歧义时无法保证完全脱敏）。

行为变化二：libpq 兼容的 keyword/value 解析器

host=... user=...形式的连接串同样重写为与 libpq 精确对齐（同样经差分模糊测试验证）：

• 反斜杠转义：反斜杠转义其后任意字符并被丢弃（旧实现只处理\\和\'）。Windows 证书/密钥路径因此必须双写反斜杠：sslcert=C:\path\to\cert会读成C:pathtocert，须写为sslcert=C:\\path\\to\\cert。
• 尾部反斜杠：非引号值中，尾部反斜杠转义字符串结尾、被丢弃并终止值（旧实现报invalid backslash）；引号值内被转义的终止符导致字符串未闭合，仍是错误。
• keyword 内空白：keyword 内部出现空白（如application_name=my app host=x）现在是解析错误（missing "=" after "us" in connection info string），而不再静默丢掉两个参数并把app host当运行时参数发给服务器。
• 未识别 keyword 仍被接受（libpq 会拒绝）；空user=仍被丢弃，使PGUSER与 OS 用户生效。

行为变化三：日期/时间文本格式手写解析器

date、timestamp、timestamptz的文本值不再依赖time.Parse/time.Format，改为手写解析器与编码器处理 PostgreSQL ISO 日期时间格式（Go 的布局语言无法表达可变宽度年份与 BC 纪元）。文本扫描路径对timestamp/timestamptz约快 2.5 倍。修复的缺陷：

• BC 闰年 2 月 29 日编码不再静默变成 3 月 1 日（4713-02-29 BC现在正确输出，此前写成4713-03-01 BC）。
• BC 闰日可扫描（此前报day out of range）。
• 9999 年之后的年份可扫描（10000-01-02 03:04:05此前无法解析，导致 simple 协议及文本格式结果中 PostgreSQL 范围高端的timestamp/timestamptz不可读）。
• simple 协议中time.Time参数正确编码 BC 日期。
• 微秒之后的小数秒按服务器同款"round half to even"舍入（PostgreSQL 只发六位小数，此变化仅影响其他来源的值）。

行为变化（可能影响现有应用）：

• date拒绝不可能日期而非归一化：2024-02-30（曾返回2024-03-01）与2024-13-01（曾返回2025-01-01）现在都是错误；timestamp/timestamptz原本就拒绝。
• 三种类型在二进制与文本格式下都拒绝超出 PostgreSQL 范围的日期；timestamptz还拒绝超出有符号 32 位秒范围的时区位移，但接受 POSIX 时区发出的宽偏移（如+16）。
• 文本格式扫描的timestamptz现在返回time.Local（或设置了ScanLocation时的该位置），与二进制格式一致。旧行为中，文本路径保留time.Parse从服务器偏移推导出的位置，两种格式可能报告不同的Location()/Zone()。连带影响：Timestamptz.MarshalJSON现在写客户端偏移而非服务器偏移——服务器发+05:30的值在 UTC-8 客户端上序列化为2024-01-01T13:34:05-08:00而非2024-01-02T03:04:05+05:30；DecodeDatabaseSQLValue也以同一位置交付time.Time。若需固定位置，将 codec 的ScanLocation设为time.UTC。
• 相关错误消息有变化。

此外，pgconn 现在仅在连接串、环境变量、服务文件均未提供用户时才解析 OS 用户账户，避免受限容器环境中的多余账户查询与崩溃；Unix 下$HOME用于密码/服务/TLS 文件的默认路径，而非 OS 账户主目录。

其他修复

Begin/BeginTx可恢复错误后保持连接；Exec在反分配失效缓存语句失败时调用TraceQueryEnd；按实际发送的语句名反分配失败的 prepare 并跳过未完成的 Parse（避免泄漏预处理语句）；LoadTypes不再用错误的ArrayCodec覆盖box/point等标量 codec；cursorFETCH等场景在缓存描述为空时取回字段描述；batch 无行返回或混用Batch.ExecStatement时保持描述与结果格式对齐；pipeline 处理空查询/纯注释查询并在 bind 错误后丢弃过期语句数据；ArrayCodec.Delimiter支持非逗号分隔符（含box[]的分号分隔符）；文本数组元素含内部空白时加引号；范围边界含分隔符/引号/反斜杠时转义并区分空串边界与无界范围；Numeric精度保持与科学计数法、JSON 中"Infinity"/"-Infinity"编解码、NaN/无穷转整数报错而非 panic、二进制 numeric 零值解码死循环修复；多级指针扫描修复；codec 全链路边界检查读取代价与畸形长度/计数/尾部数据拒绝；hstore 文本解析的初始分配上限；pgconn 引号值末尾反斜杠不再 panic；错误消息对 URI 查询参数中的password/sslpassword脱敏（含pass%77ord=这类百分号拼写）；asyncClose先 drain socket 再关闭以产生 TCP FIN 而非 RST（来自 CrowdStrike）；StartupMessage.Encode拒绝参数名/值中的 NUL 字节（防application_name=x\x00user\x00admin改变登录角色这类注入），keyword/value 串中的 NUL 由ParseConfig拒绝。

四、v5.10.0（2026-06-03）：针对恶意服务器的系统性加固

本版由 CrowdStrike 的 Sean Chittenden 主导，目标是对抗恶意或失陷 PostgreSQL 服务器：

• require_auth：限制服务器可用的认证方法，缓解sslmode=prefer下的降级攻击。
• ParseConfigOptions.ConnStringAllowedKeys：限制连接串允许的 key。
• StructArgs/StrictStructArgs：面向@命名查询的实参类型。
• ErrConnClosed哨兵错误：并从connLockError解包。
• pgxpool：获取连接前先检查连接是否过期。
• 安全加固：主连接使用 TLS 时CancelRequest也走 TLS；服务端 SCRAM 迭代次数设上限；Frontend 最大消息体长度默认约 1 GiB；hstore、数组、range/multirange/tsvector 的二进制解码均按剩余消息字节限界；畸形几何文本返回错误而非 panic。
• 修复：二进制格式下"char"（OID 18）扫描进*string；typed-nildriver.Valuer在数组/复合 codec 中的处理；CopyData.Data十六进制解码；连接期间上下文取消的数据竞争；parseKeywordValueSettings尾部空白；pgxpoolMaxLifetimeDestroyCount与获取时过期检查的 ping 顺序等。

五、v5.9.x：安全修复与协议 3.2 时代

v5.9.2（2026-04-18）：占位符混淆型 SQL 注入（GHSA-j88v-2chj-qfwx）

漏洞条件是：使用非默认的 simple 协议 + SQL 中出现美元引号字符串字面量 + 字符串外存在被解释为占位符的文本 + 占位符值由攻击者控制：

attackValue := `$tag$; drop table canary; --` _, err = tx.Exec(ctx, `select $tag$ $1 $tag$, $1`, pgx.QueryExecModeSimpleProtocol, attackValue)

CHANGELOG 明示这在刻意构造的场景之外不太可能发生。这也解释了为什么 Nakama 中所有数据库访问都经由database/sql（默认走扩展协议与预处理语句），而不是直接驱动 simple 协议。

v5.9.1（2026-03-22）

修复使用缓存预处理语句时 batch 结果格式损坏的问题。

v5.9.0（2026-03-21）

• 要求 Go 1.25+。
• 新能力：SCRAM-SHA-256-PLUS（通道绑定）、PostgreSQL 18 的 OAuth 认证、PostgreSQL 协议 3.2、tsvector 类型支持。
• 网络流量显著下降：缓存预处理语句时跳过不必要的 Describe Portal 消息（预处理语句默认自动使用），同时降低本地内存占用。
• 默认空用户匹配 libpq 行为（取当前 OS 用户）。
• LRU 语句缓存改用自定义链表与节点池、日期扫描以手写解析替代正则、RowsAffected提速。
• 修复：Pipeline 在服务器发多个 FATAL 时的 Close panic、ContextWatchergoroutine 泄漏、stdlib 在ResetSession时丢弃带打开事务的连接、ColumnTypeLength误用 BPCharArrayOID、32 位平台消息长度解析、numeric 扫描溢出、int2/int4 下溢错误消息等；并抵御多种畸形二进制消息导致的 panic/OOM。

六、v5.8.0 至 v5.5.0：持续优化与连接池能力补全

v5.8.0（2025-12-26）

要求 Go 1.24+；移除 golang.org/x/crypto 依赖；OptionShouldPing控制ResetSession的 ping 行为；MaxConns设为 MaxInt32 时避免溢出；pgxpool 后台 goroutine 更快关闭；pgxpool ping 超时；Rows.FieldDescriptions处理空查询；未知类型按格式码扫描为 string 或 []byte；AfterNetConnect钩子加入pgconn.Config；从math/rand迁移到math/rand/v2；iobufpool 与 stmtcache 失效优化；ColumnTypeLength对 varbit 返回类型长度；数组/复合 codec 处理 typed nil。

v5.7.x

• v5.7.6：ParseConfigError用于pgx.ParseConfig/pgxpool.ParseConfig；pgxpool 的PrepareConn钩子；QueryContext分配减少；pgtype.Uint32的 JSON 编解码；pgxpool 的ShouldPing行为配置；zeronull int 类型实现Int64Valuer/Int64Scanner；CopyFrom 收到终止连接消息时的 panic 修复；batch 出错时语句缓存失效修复。
• v5.7.5：sslnegotiation连接选项；PGTZ、PGOPTIONS环境变量支持；TraceLog在 debug 级别记录 Acquire/Release；更早释放 Rows 占用的内存；移除 PlanScan 记忆化以修复"先扫描某类型破坏另一类型扫描"的罕见问题（基准测试显示记忆化无实际收益）。
• v5.7.4：回退 JSONnull扫描变更。
• v5.7.3：pgxpool.Stat 暴露EmptyAcquireWaitTime；SQL 净化器性能改进；json(b) 扫描、sql.Scanner、自动解引用之间的混淆修复；xml 类型Values()返回 []byte；pipeline 模式可发送 Flush 消息；pgtype.Timestamp的 JSON 行为对齐 PostgreSQL；MinIdleConns加入 pgxpool；更贴近 libpq 的连接回退行为。
• v5.7.2：batch prepare 失败时的"prepared statement already exists"修复；tx 选项支持 commit query；前后端消息体大小限制；xid8 类型；pgtype.UUID.String()；编码/扫描无限递归防护。
• v5.7.1：tracelog.TraceLog数据竞争修复；puddle 升级（移除 linkname 方式导入 nanotime）。
• v5.7.0：sslrootcert=system；LoadTypes单次 SQL 查询加载多类型；XMLCodec 像 json 一样编码/扫描 XML 列；MultiTrace；TraceLogConfig自定义 TimeKey；pgx.ErrNoRows包装sql.ErrNoRows以兼容 database/sql；二进制 uint32 扫描进 string/TextScanner；interval 编码允许 0s 并去除多余空格；RowToStructByName 的 snake_case 归一化与 db tag 冲突修复。

v5.6.0（2024-05-25）

StrictNamedArgs；macaddr8 类型；SeverityUnlocalized字段；RowToStructByPos/Name性能优化；pgconn 可自定义 context 取消行为；ScanLocation加入pgtype.Timestamp[tz]Codec（即 5.11 中提到的固定时区手段的来源）；pgconn 自定义数据；SafeToRetry处理包装错误；失败的连接尝试汇总所有错误；LargeObject.Read优化；连接池 acquire/release 追踪；TCP 连接使用 Go 默认 keepalive。

v5.5.x

• v5.5.5：SQL 净化改用空格而非括号，解决负数产生行注释的同时避免破坏set foo to $1等任意表达式不允许的场合。
• v5.5.4：修复CVE-2024-27304——单个查询或 bind 消息超过 4GB 时消息大小整数溢出，导致一个超大消息被拆成攻击者可控的多个消息，造成 SQL 注入；CollectRows空结果返回空切片；simple 协议编码json.RawMessage修复等。
• v5.5.3：prepared statement already exists修复；CopyFrom 文本值自动转换改进；ltree 类型；Batch/QueuedQuery 部分属性公开；AppendRows；UUID 字节转字符串优化；LargeObject 单次 1GB 以上读写修复。
• v5.5.2：NamedArgs 支持下划线开头；pgproto3 最大消息体长度；RowToStructByNamesnake_case；OnPgError 集中错误处理；pipeline 关闭检查。
• v5.5.1：CopyFromFunc；PgConn.Deallocate使用协议 Close 消息，使失效事务中也能反分配语句、修复预处理语句映射失效问题；simple 协议净化器对非法$0占位符返回错误而非 panic。
• v5.5.0：CollectExactlyOneRow；OpenDBFromPool由*pgxpool.Pool创建*database/sql.DB；Prepare 可按 SQL 自动命名语句，缓存语句名确定且稳定；SendBatch尊重 context 取消；CancelRequest 等待服务器确认（改善 PgBouncer 兼容性）；Float4/Float8 的 JSON 编解码。

七、v5.4 至 v5.0：回归与兼容

• v5.4.0：放弃平台特定系统调用实现的非阻塞 IO，回归 goroutine + deadline 方案（v4 思路 + 改进），恢复在 ssh.Conn 及非 TCP/Unix socket 上使用 pgx.Conn 的能力，实现显著简化、跨平台问题更少。默认类型注册改为跨连接共享，每连接节省约 100KB 内存（pgtype.Type/pgtype.Codec注册后必须不可变）；QueryRow.Scanpanic 时确保释放连接；BeforeClose加入 pgxpool；bool 类型别名、行转结构体（含未导出内嵌结构体）、batch 错误路径等大量修复；新增RowTo(AddrOf)StructByNameLax。
• v5.3.x：同程序内 v4/v5 stdlib 共存；sql.Scanner修复；jsonpath 文本格式；CopyFrom 查询缓存减少往返；driver.Value 中 bytea 应为 []byte；支持重命名基础类型上的 sql.Scanner；多主机名部分解析失败仍可连接；大量内存分配削减。
• v5.2.0：tracelog.TraceLog实现pgx.PrepareTracer；Conn.LoadType支持 range/multirange；numeric 扫描进 uint/uint64 的修复。
• v5.1.0：puddle v2.1.2（修复 pgxpool 竞态与死锁）；QueryRewriter.RewriteQuery返回 error；GetSSLPassword支持；5 位数字年份的日期文本编码；domain 类型Conn.LoadType()支持；RowToStructByName/RowToAddrOfStructByName；Conn.DeallocateAll()。
• v5.0.4/v5.0.3/v5.0.2/v5.0.1：CollectOneRow优先 PostgreSQL 错误；driver.Valuer边缘处理避免死循环/崩溃；日期文本编码月份/日期恒为两位；指针到指针到重命名类型的扫描；NULL 在 PG 与 Go 类型不兼容时仍可扫描；32 位原子操作修复；Float8MarshalJSON；Lseg 文本编码加[/]；sqlScannerWrapper NULL 处理。

八、升级与运维实践要点

基于上述版本脉络，结合 Nakama 的集成方式，给出面向工程实践的检查清单：

1. 连接字符串是最大行为面：v5.11 将 URI 与 keyword/value 解析器全面对齐 libpq。存量连接串若有+、裸 IPv6、重复参数、多主机混合端口、反斜杠路径（Windowssslcert/sslkey）等写法，升级后行为会变化——建议升级前用pgx.ParseConfig对生产连接串做一次回归验证。Nakama 的 server/db.go#L42-L69 恰好是pgx.ParseConfig的直接调用点，可借此快速验证。
2. 日期时间语义变更：timestamptz文本扫描现在统一返回time.Local或ScanLocation，MarshalJSON输出客户端偏移。需要固定位置时显式设置 codec 的ScanLocation为time.UTC；涉及 BC 日期、超 9999 年份、2024-02-30这类非法日期的输入要按"拒绝而非归一化"处理。
3. 安全底线：保持pgx在最新修补版本（5.9.2 的占位符注入、5.5.4 的 CVE-2024-27304、5.10 的服务器侧加固都值得跟进）；尽量不要使用 simple 协议执行含美元引号字符串的查询。
4. 连接池与探测：pgxpool 的pool_ping_timeout、MinIdleConns、OptionShouldPing、MaxConnLifetime非正值视为无限等行为，直接影响 Nakama 这类长生命周期服务在高负载下的连接健康度；MaxProtocolMessageBodyLen可用于限制恶意服务器的超大消息。
5. 错误处理范式：v5 中pgconn.PgError+pgerrcode是分类数据库错误的官方路径（Nakama 在 server/api_account.go 等处使用errors.AsType[*pgconn.PgError]），配合ErrConnClosed、只读/主备哨兵错误，可用errors.Is精确分支。

pgx v5 的演进主线始终清晰：以 libpq 兼容性为锚点收敛连接串行为，以安全加固对抗恶意服务器，以类型系统重构换取扩展性与性能。对 Nakama 而言，这个驱动不仅承担 SQL 读写，更是事务、连接池轮换、错误分类等核心路径的底层支柱——理解其版本变更，就是理解 Nakama 数据库层的运行边界。

• 后端
• 即时通讯
• 社交
• 游戏开发