SetConnMaxIdleTime必须搭配SetMaxIdleConns才生效，否则连接无法进入空闲队列，该参数形同虚设；推荐设为略小于MySQL的wait_timeout（如DB为60s则Go设45s），且仅Go 1.15+支持，需通过db.DB()获取*sql.DB后调用。
SetConnMaxIdleTime 必须搭配 SetMaxIdleConns 才生效
单独调用 sqlDB.SetConnMaxIdleTime(45 * time.Second) 不会清理任何连接——因为连接得先进入“空闲队列”，而队列容量由 SetMaxIdleConns 控制。如果没设或设为 0，连接用完立刻销毁，根本不会闲置，SetConnMaxIdleTime 就无从触发。
常见错误现象：压测后 SHOW PROCESSLIST 里全是 SLEEP 状态连接，长期不释放；服务跑几小时后空闲连接堆积上百。
-
SetMaxIdleConns建议设为SetMaxOpenConns的 1/2～2/3（例如最大 100 → 空闲设 40～60） - 若
SetMaxIdleConns(20)，那最多只有 20 个连接能进入空闲队列，SetConnMaxIdleTime只对这 20 个起作用 - Go 1.12+ 下，若
SetMaxIdleConns > SetMaxOpenConns，会 panic 报错："max idle conns exceeds max open conns"
值要略小于 MySQL 的 wait_timeout
SetConnMaxIdleTime 不是“保活”机制，而是“主动淘汰”策略。它决定空闲连接在池里最多待多久，超时即关闭。如果设得太长（比如 1 小时），而 MySQL 的 wait_timeout 是 60 秒，那连接会被 DB 先断开，下次复用就报 invalid connection 或 read: connection reset by peer。
- 查 MySQL 实际值：
SHOW VARIABLES LIKE 'wait_timeout';（常见为 60、300 或 600 秒） - 推荐设为比它小 10～15 秒，例如 DB 设 60s → Go 设
45 * time.Second - 云数据库（如阿里云 RDS）常默认 300s，可设
270 * time.Second - 绝对不要设成
0或time.Hour：前者无效，后者等于放弃控制
必须通过 db.DB() 获取底层 *sql.DB 设置
GORM v2 的 *gorm.DB 是封装，连接池参数全在它包装的 *sql.DB 里。直接在 gorm.Open() 返回值上调用 SetConnMaxIdleTime 会编译失败。
- 正确写法：
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
if err != nil {
panic(err)
}
sqlDB, err := db.DB()
if err != nil {
panic(err)
}
sqlDB.SetMaxOpenConns(100)
sqlDB.SetMaxIdleConns(40)
sqlDB.SetConnMaxIdleTime(45 * time.Second) // ← 这里才真正起作用
sqlDB.SetConnMaxLifetime(2 * time.Minute)
- 漏掉
db.DB()这一层，所有设置都只是“对空气调用” - 注意：该方法仅 Go 1.15+ 支持，旧版本只能靠
SetConnMaxLifetime+ 被动等待
和 DSN 中的 timeout 参数完全无关
很多人把 DSN 里的 timeout=10s、readTimeout 或 MySQL 驱动的 DialTimeout 当成空闲超时，这是典型误解。它们只管“建连阶段”的握手耗时，一旦连接成功建立，这些参数就失效了。
-
timeout=10s在 DSN 中：控制 TCP 握手 + 登录认证总耗时上限 -
DialTimeout、ReadTimeout：影响单次网络 I/O，不是连接生命周期管理 - 真正管“空闲多久该关”的，只有
SetConnMaxIdleTime，且必须显式调用 - 验证是否生效：启动后等 5 分钟，执行
SELECT COUNT(*) FROM pg_stat_activity WHERE state = 'idle'（PostgreSQL）或观察SHOW PROCESSLIST中 SLEEP 连接是否回落
实际配置中容易忽略的是：它和 SetConnMaxLifetime 解决的问题不同层——后者防长连接老化（主备切换、防火墙静默断连），前者防空闲连接积压（资源泄漏、DB 端连接数虚高）。两个都得设，且数值逻辑不能冲突。
