可通过调用 sql.db.stats() 获取实时连接池指标，包括 openconnections、idle、waitcount 和 waitduration 等快照值，需定时采集；db.ping() 不反映池健康状况；合理配置 setmaxopenconns、setmaxidleconns 和 setconnmaxlifetime 才能优化池行为；接入 prometheus 时需按指标类型（gauge/counter）正确暴露。
怎么拿到 sql.DB 的实时连接池指标
Go 标准库的 database/sql 包本身不暴露连接池内部状态，但提供了几个关键方法供你主动查询。最常用的是 DB.Stats() ——它返回一个 sql.DBStats 结构体，包含当前活跃连接数、空闲连接数、等待获取连接的 goroutine 数等核心数据。
注意：这些是快照值，不是持续流式指标；调用一次就取一次，需自行定时采集。
-
DB.Stats().OpenConnections：当前已打开（包括忙 + 空闲）的底层连接总数 -
DB.Stats().Idle：当前空闲、可立即复用的连接数 -
DB.Stats().WaitCount：历史上总共多少次因连接不足而排队等待 -
DB.Stats().WaitDuration：所有等待累计耗时（time.Duration），若为 0 说明没发生过阻塞
为什么 DB.Ping() 不能反映连接池健康状况
DB.Ping() 只是尝试建立一个新连接并执行 PING 命令，它绕过了连接池逻辑，既不复用空闲连接，也不触发连接创建/回收流程。所以即使 Ping() 成功，也不能说明池里有可用连接；反之，Ping() 失败也不代表池已枯竭——可能只是网络或数据库宕了。
真正体现池压力的是 WaitCount 和 WaitDuration 持续上升，或者 Idle 长期为 0 且 OpenConnections 达到 SetMaxOpenConns() 上限。
- 高
WaitCount+ 非零WaitDuration→ 请求在排队，池太小或慢查询拖住连接 -
Idle == 0且OpenConnections == MaxOpen→ 池被占满，新请求必须等 -
OpenConnections远低于MaxOpen但响应变慢 → 可能是连接泄漏（比如Rows没Close()）
设置连接池参数时最容易错的三个地方
Go 的连接池行为高度依赖三个 sql.DB 方法的组合效果，单独调大某一个往往没用，甚至起反作用。
-
SetMaxOpenConns(n)：控制最大并发连接数。设为 0 表示无限制（危险！）；设太小会导致排队，设太大可能打爆数据库。建议从 20–50 起步，按压测结果调优 -
SetMaxIdleConns(n)：控制空闲连接上限。默认是 2，太小会导致频繁建连/销毁；但不能超过MaxOpen，否则无效 -
SetConnMaxLifetime(d)：强制连接在存活时间后关闭。不设或设太长（如 24h）会导致连接僵死（尤其在数据库重启、LB 断连后）；推荐 30m–1h
常见错误：只调 MaxOpen，忽略 MaxIdle 和 ConnMaxLifetime，结果是连接数上不去、空闲连接被快速回收、旧连接卡死不释放。
如何把 DB.Stats() 接入 Prometheus
没有现成 exporter，得自己暴露 HTTP handler 把 Stats() 转成 Prometheus 格式。关键是别直接暴露原始结构体字段，要映射成带标签的指标，比如按数据库名、环境区分。
示例片段（省略 HTTP server 初始化）：
func statsHandler(db *sql.DB, dbName string) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
stats := db.Stats()
fmt.Fprintf(w, "# HELP go_db_open_connections Number of open connections\n")
fmt.Fprintf(w, "# TYPE go_db_open_connections gauge\n")
fmt.Fprintf(w, "go_db_open_connections{db=\"%s\"} %d\n", dbName, stats.OpenConnections)
fmt.Fprintf(w, "# HELP go_db_idle_connections Number of idle connections\n")
fmt.Fprintf(w, "# TYPE go_db_idle_connections gauge\n")
fmt.Fprintf(w, "go_db_idle_connections{db=\"%s\"} %d\n", dbName, stats.Idle)
// 其他字段同理...
}
}
注意：WaitCount 和 WaitDuration 是累加值，Prometheus 客户端应作为 counter 类型上报，而非 gauge；否则 rate() 计算会出错。
真实部署时，别让监控 endpoint 频繁调用 Stats()（比如每秒多次），它虽轻量但非零开销；10s 采样间隔通常足够。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
