sql.db 本身就是内置连接池的句柄，无需手动实现；调用 sql.open 仅初始化配置，首次 query/exec 才建连，需显式 db.ping() 验证连通性，且应全局复用、避免 defer db.close()。
为什么 sql.DB 本身就是连接池，不需要自己实现
Go 的 database/sql 包里 sql.DB 不是单个数据库连接，而是一个**内置连接池的句柄**。你调用 sql.Open 时只是初始化配置，并不真正建连；首次 Query 或 Exec 才会按需拨号。很多人误以为要手写池子，其实徒增复杂度还容易出错。
常见错误现象：sql.Open 后立刻检查 err 却没报错，但后续查询却超时或连不上——因为 sql.Open 不校验连接有效性，得显式调用 db.Ping()。
- 必须在
sql.Open后加db.Ping()做初始连通性验证 -
sql.DB是并发安全的，可全局复用，无需每个请求 new 一个 - 不要 defer
db.Close()在函数内——它应存活整个应用生命周期
SetMaxOpenConns、SetMaxIdleConns 和 SetConnMaxLifetime 怎么设才合理
这三个参数直接影响池行为和数据库负载。设得太小，高并发下大量 goroutine 阻塞在 acquireConn；设太大，可能打爆数据库连接数或触发 MySQL 的 max_connections 限制。
典型使用场景：Web 服务（如 HTTP handler）每请求执行 1–3 次查询，QPS 200，MySQL 默认 max_connections=151。
-
SetMaxOpenConns(50)：建议设为数据库侧允许最大连接数的 60%～70%，留余量给后台任务 -
SetMaxIdleConns(20)：通常设为MaxOpenConns的 1/2～2/3，避免空闲连接长期占着资源又不释放 -
SetConnMaxLifetime(1h)：强制复用连接不超过 1 小时，防止因网络中间件（如 AWS ALB、iptables timeout）静默断连后出现broken pipe
注意：SetConnMaxLifetime 不是连接空闲超时，空闲超时靠 SetConnMaxIdleTime（Go 1.15+），旧版本只能靠 MaxIdleConns + 主动回收逻辑模拟。
如何发现连接池已成瓶颈
不是所有慢查询都怪 SQL，有时是连接池卡住了。关键看日志和指标中是否频繁出现等待连接的痕迹。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
常见错误现象：context deadline exceeded 报错位置在 database/sql.(*DB).conn 内部，或 pprof 火焰图里大量时间花在 runtime.semasleep —— 这基本是 goroutine 在等空闲连接。
- 开启
db.SetConnMaxIdleTime(30s)（Go 1.15+）并观察sql.DB.Stats().WaitCount是否持续增长 - 定期打印
db.Stats()：重点关注WaitCount（总等待次数）、WaitDuration（总等待时长）、MaxOpenConnections是否长期打满 - MySQL 侧查
SHOW PROCESSLIST，若大量连接状态为Sleep且 Command 是Sleep，说明 Go 客户端没及时归还连接（比如忘了 closerows）
容易被忽略的一点：rows.Close() 必须调用，否则连接不会归还池——哪怕用了 defer rows.Close()，也要确保它真被执行（比如没被提前 return 跳过）。
事务中连接池行为与 db.BeginTx 的陷阱
事务会从池中独占一个连接，直到 tx.Commit() 或 tx.Rollback()。如果事务执行慢或忘记结束，这个连接就一直被锁住，间接拖垮整个池。
使用场景：需要强一致读写的业务逻辑，比如扣库存+写订单。
- 永远用带 context 的
db.BeginTx(ctx, opts)，避免事务无限期挂起 - 不要在事务里调用其他依赖同一
sql.DB的函数——它们可能抢不到连接，造成死锁或超时 - 如果事务内需调用外部 API，务必设好 timeout，防止外部延迟把连接卡死
-
tx.QueryRow返回的row仍需Scan，否则连接不释放；tx.Query的rows更要显式Close
最隐蔽的问题：嵌套事务（比如函数 A 开事务，调用函数 B 又开事务）在 Go 里不会自动升级，而是新建连接，极易耗尽池子——应统一用传入的 *sql.Tx，而非再调用 db.BeginTx。
