SetMaxOpenConns必须设为数据库max_connections的60%～80%，禁用默认0值以防Too many connections；需先查SHOW VARIABLES LIKE 'max_connections'，再通过db.DB().SetMaxOpenConns(n)设置，且SetMaxIdleConns必须≤该值并配SetConnMaxLifetime（2～5分钟）防失效连接。
SetMaxOpenConns 必须设，不能为 0
默认值 SetMaxOpenConns=0 表示无上限，上线后 MySQL 很快报 Too many connections，P99 延迟可能从 50ms 拉到 800ms+。这不是代码慢，是连接池和数据库“呼吸节奏”没对上。
正确做法是先查数据库真实容量：
-
SHOW VARIABLES LIKE 'max_connections';—— 假设返回 200，则设SetMaxOpenConns为 120～160（60%～80%） - 云数据库（如阿里云 RDS）更保守：按每核 ≈20 连接估算，别套物理机配置
- 设成 500：MySQL 立即拒绝新连接，错误日志刷屏
Too many connections - 设成 10：20 个 goroutine 并发查用户，全卡在等连接，QPS 上不去，平均延迟反而升高
注意：SetMaxOpenConns 必须通过 db.DB().SetMaxOpenConns(n) 设置，不是 gorm.Open 的参数 —— GORM 不接管连接池，只透传底层 *sql.DB。
SetMaxIdleConns 和 SetConnMaxLifetime 必须配对用
只调 SetMaxIdleConns 不设 SetConnMaxLifetime，等于让空闲连接赖着不走。云环境 NAT 网关或防火墙会在 3～5 分钟后静默断连，下次复用直接报 read: connection reset by peer。
立即学习“go语言免费学习笔记（深入）”；
推荐组合：
-
SetMaxIdleConns设为SetMaxOpenConns的 1/2 到 2/3（例如最大 100 → 空闲设 40～60） -
SetConnMaxLifetime推荐 2～5 分钟：云数据库主备切换快，设 2 分钟更安全；自建 MySQL 可设 5 分钟 - 千万别设成 0 或
time.Hour：长期存活连接容易在 DB 侧积压idle in transaction，锁资源、占内存、触发上下文切换风暴
注意：SetMaxIdleConns(n) 若大于当前 SetMaxOpenConns 值，Go 1.12+ 会直接 panic，错误信息为 "max idle conns exceeds max open conns"。务必先设 SetMaxOpenConns，再设 ≤ 它的 SetMaxIdleConns。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
db.Ping() 是启动必检项，不是可选动作
sql.Open() 或 gorm.Open() 只是初始化连接池结构，不建真实连接。很多服务日志写着 “DB initialized”，其实第一笔查询才真正拨号——这时候网络不通、密码错、DNS 解析失败，全堆在首请求上，导致线上首屏白屏。
所以必须在应用启动完成时立即调用：
-
db.Ping()验证初始连通性 - 后续用
db.Stats().InUse、Idle、WaitCount持续监控调优
注意：db.Ping() 只验证“此刻能建一个连并执行 SELECT 1”，它不检查池中已有空闲连接是否还活着。失效不发生在 Ping()，而发生在 Query() 归还后 —— 所以 k8s readiness probe 若只调 db.Ping()，可能误判服务可用。
连接池参数必须在全局初始化阶段设置
GORM / Gin / Echo 中若把 sql.Open 写在 handler 里，每次请求都新建池 → 连接泄漏、fd 耗尽、database is closed 频发。
正确姿势：
- 应用启动时全局初始化一次
*sql.DB（或*gorm.DB），注入到 handler 或 service 层复用 - 框架（如 GORM、Echo 中的 DB middleware）只是封装了
*sql.DB的使用方式，并不改变其池行为 - 常见错误：在 GORM 初始化时只传
&gorm.Config{}，却没调gormDB.DB().SetMaxOpenConns(20)→ 池仍用默认值MaxOpenConns=0
最易被忽略的一点：所有连接池参数都作用于底层 *sql.DB 实例，且必须在首次执行 SQL 前完成设置 —— 一旦有并发查询开始，再改参数就可能引发竞态或无效。
