Go database/sql 连接池：MaxOpenConns 不是越大越好

接口并发最终经常落到数据库。MaxOpenConns 设置太小会排队，设置太大又可能把数据库打满。连接池调优不是背参数，而是结合数据库容量、SQL 耗时和接口并发预算一起算。

MaxOpenConns 控制最大并发连接

它决定当前进程最多同时占用多少数据库连接。多个应用实例相加后，不能超过数据库可承受连接数和业务查询能力。

MaxIdleConns 减少建连抖动

空闲连接太少会频繁建连，太多会长期占用数据库资源。通常先设置为 MaxOpenConns 的一部分，再通过 DBStats 观察。

WaitCount 是排队信号

DBStats 中 WaitCount 和 WaitDuration 增长，说明业务正在等待连接。此时不要立刻加大连接数，还要看慢 SQL、事务耗时和下游容量。

生产场景

适用于所有依赖 MySQL、PostgreSQL 或类似关系型数据库的 Go 服务。连接池参数会直接影响接口并发、慢 SQL 暴露速度和数据库稳定性。

关键指标

• DBStats WaitCount、WaitDuration、OpenConnections
• 慢 SQL 数量、锁等待和事务耗时
• 应用实例数乘以 MaxOpenConns 后的总连接预算

常见误区

• 看到 WaitCount 增长就直接加大连接数
• MaxOpenConns 大于数据库实际承载能力
• 长事务持有连接和锁，拖慢其它请求

落地建议

建议先用慢查询和事务耗时定位根因，再调连接池。连接数要和数据库规格、实例数量、SQL 平均耗时一起算，调大后必须观察数据库 CPU、锁等待和错误率。

代码示例

db.SetMaxOpenConns(40)
db.SetMaxIdleConns(20)
db.SetConnMaxLifetime(30 * time.Minute)

stats := db.Stats()
log.Printf("wait=%d duration=%s open=%d", stats.WaitCount, stats.WaitDuration, stats.OpenConnections)

上线检查

• 每个服务实例的连接数乘以实例数后仍在数据库预算内。
• 监控 DBStats。
• 所有查询使用 QueryContext 或 ExecContext。