延迟加载是控制sql.Open()和db.Ping()时机的问题，而非连接池功能；应避免init中初始化，改在首次使用前延迟执行，并配合适当超时。
延迟加载不是连接池的事，是配置和初始化的时机问题
Go 的 database/sql 连接池本身不支持“延迟加载连接”，它只在第一次调用 db.Query()、db.Exec() 等方法时才真正拨号建连。所谓“延迟加载”，其实是你控制 sql.Open() 和 db.Ping() 的时机——别在应用启动时就急着连库，而是等第一个真实请求到来、或某个模块首次需要 DB 时再初始化。
常见错误是：全局变量 var db *sql.DB + init 函数里直接 sql.Open + db.Ping()，导致服务一启就报错失败，或卡在不可达数据库上。
- 把
sql.Open()移到首次使用前，比如 HTTP handler 内部、或依赖注入容器的 lazy provider 中 - 若必须提前初始化（如健康检查需要），用
context.WithTimeout(ctx, 2*time.Second)包裹db.PingContext()，避免阻塞启动 - 不要在
init()或包级变量赋值中做任何 I/O，包括db.Ping() - GORM 用户注意：
gorm.Open()返回的是*gorm.DB，但底层*sql.DB仍需你手动调db.DB().Ping()校验，且这个动作也应延迟
SetMaxOpenConns 设多少才不翻车
SetMaxOpenConns 不是越大越好，设高了反而触发 ERROR 1040 (HY000): Too many connections 或让 P99 延迟飙升。它的值必须对齐数据库实际能力。
- 先查数据库真实上限：
SHOW VARIABLES LIKE 'max_connections';（MySQL）或SELECT setting FROM pg_settings WHERE name = 'max_connections';（PostgreSQL） - 生产环境推荐设为该值的 60%～80%，例如 MySQL
max_connections=151→SetMaxOpenConns(100) - 更精细的估算方式：
峰值 QPS × 平均查询耗时（秒）× 1.5，结果取整后不能超过上一步的硬上限 - 绝对不要保留默认值 0（无限制），这是线上事故头号诱因
SetMaxIdleConns 和 SetConnMaxIdleTime 必须配对用
只设 SetMaxIdleConns 不设 SetConnMaxIdleTime，空闲连接会一直挂着不释放；只设后者不设前者，又可能把刚热身完的连接误杀。Go 1.15+ 必须启用 SetConnMaxIdleTime。
立即学习“go语言免费学习笔记（深入）”；
-
SetMaxIdleConns一般设为SetMaxOpenConns的 1/2 到 2/3（如 Open=100 → Idle=50） -
SetConnMaxIdleTime必须小于SetConnMaxLifetime，常见组合是5 * time.Minute和30 * time.Minute - 云数据库（如 AWS RDS、阿里云 PolarDB）建议把
SetConnMaxIdleTime缩短到2 * time.Minute～5 * time.Minute，适应主备切换 - 漏设
SetConnMaxIdleTime是导致 “connection reset by peer” 和 “server closed the connection” 报错的高频原因
最容易被忽略的连接泄漏点：rows.Close() 和 tx.Commit()
连接池不会因为你函数 return 就自动回收连接。没显式关 *sql.Rows、没提交/回滚 *sql.Tx，连接就永远卡在 InUse 状态，db.Stats().WaitCount 会持续上涨。
-
rows, _ := db.Query(...)后，无论rows.Next()是否返回true，都必须写defer rows.Close() -
tx, _ := db.Begin()后，必须配对defer tx.Rollback()+ 显式tx.Commit()，不能只靠 defer - 事务内禁止混用
tx.Query()和db.Query()：后者绕过事务，还额外占一个连接 - 用
db.Stats()定期看InUse是否长期等于MaxOpenConnections，是泄漏最直接信号
连接池参数不是一次设完就高枕无忧，db.Stats() 里的 WaitCount、InUse、Idle 三个字段得盯住趋势，而不是某次快照值。真正难调的从来不是数字，而是那些没 Close、没 Commit、没加 context 超时的 goroutine。
