必须显式设置db.SetMaxOpenConns()和db.SetMaxIdleConns(),因默认SetMaxOpenConns(0)无上限,高并发易触发“Too many connections”;推荐设为50和20,并配合SetConnMaxLifetime(1*time.Hour)防老化连接。

db.SetMaxOpenConns() 和 db.SetMaxIdleConns() 必须显式设置
Go 的 sql.DB 默认不设连接池上限,SetMaxOpenConns(0) 表示无限制,这在高并发下极易耗尽数据库连接或触发 MySQL 的 max_connections 拒绝新连接。实际压测中,未配置时 QPS 上去后常伴随 ERROR 1040 (HY000): Too many connections。
推荐组合(以中等负载 API 为例):
-
db.SetMaxOpenConns(50):控制最大并发连接数,建议 ≤ 数据库服务器允许的总连接数 × 0.7 -
db.SetMaxIdleConns(20):空闲连接保留在池中复用,避免频繁建连;值不宜超过MaxOpenConns -
db.SetConnMaxLifetime(1 * time.Hour):强制回收老化连接,防止因网络闪断、MySQL wait_timeout 导致的 stale connection 错误
别让 db.QueryRow() 或 db.Exec() 在 handler 里裸奔
没配超时、没走连接池复用的调用,等于把 goroutine 卡在 I/O 上。哪怕只多 100ms 延迟,QPS 就可能掉 30%+。
必须做到:
- 所有 DB 调用都基于
c.Request.Context(),并套一层context.WithTimeout(),例如:ctx, cancel := context.WithTimeout(c.Request.Context(), 800*time.Millisecond) - 用
db.QueryRowContext(ctx, ...)替代db.QueryRow(),否则超时控制完全失效 - 避免在循环里反复调用
db.QueryRow()—— N+1 查询比连接池配置错误更伤性能
连接池参数要和业务节奏对齐,不是越“大”越好
盲目调高 MaxOpenConns 可能引发反效果:MySQL 端连接上下文开销增大、锁竞争加剧、甚至拖慢单条查询响应。我们在线上见过 MaxOpenConns=200 反而比 80 时 P95 延迟高 2 倍的情况。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
判断依据看两个指标:
- 监控
db.Stats().Idle和db.Stats().InUse:如果Idle长期接近MaxIdleConns,说明池子偏大;如果InUse == MaxOpenConns频繁出现,且请求延迟升高,才是真瓶颈 - 结合 MySQL 的
Threads_connected和Threads_running:后者持续 > 50 通常意味着查询本身慢,而非连接不够
sync.Pool 不适用于数据库连接,但适合配套对象
sql.DB 本身已内置连接池,你不需要、也不应该用 sync.Pool 去“池化” *sql.Conn。强行取 conn 再放回会破坏事务和上下文绑定,极易出错。
但可以池化高频创建的配套对象:
- JSON 解析用的
bytes.Buffer或jsoniter.Iterator - 结构体解码前的临时
map[string]interface{}或[]byte缓冲区 - 自定义 DAO 层的查询参数 struct 实例(如
UserQueryParams)
这类复用能显著降低 GC 压力,实测在 5k QPS 下 GC pause 时间下降 40%+。


















