SetConnMaxIdleTime是唯一控制空闲连接主动释放的核心参数，必须搭配SetMaxIdleConns使用且仅Go 1.15+支持；它决定空闲连接在池中存活上限，超时即关闭，而非依赖复用或GC，DSN中的timeout等参数与此无关。
必须用 SetConnMaxIdleTime，且只在 Go 1.15+ 有效；不设 SetMaxIdleConns 就等于白配。
为什么 SetConnMaxIdleTime 是唯一靠谱的配置
Go 的 sql.DB（GORM 底层依赖它）根本没有叫“空闲超时”或“idle timeout”的参数。真正起作用的只有 SetConnMaxIdleTime：它控制一个空闲连接在连接池里最多待多久，超时后会被主动关闭——不是等下次复用才发现失效，更不是靠 GC 清理。
- 常见错误现象：压测后 DB 端
SHOW PROCESSLIST里堆满SLEEP状态连接，几小时都不释放 - DSN 里的
timeout=10s或 MySQL 驱动的DialTimeout只管新建连接握手阶段，跟空闲生命周期完全无关 -
ReadTimeout/WriteTimeout是单次 I/O 超时，不影响连接池管理
怎么设才不踩坑：值、时机、配套参数
光调 SetConnMaxIdleTime 不行，它必须和 SetMaxIdleConns 搭配使用，否则连接压根不会进空闲队列，自然也谈不上“超时”。
- 先确保设置了
SetMaxIdleConns（比如20），否则SetConnMaxIdleTime不生效 - 值推荐设为略小于 MySQL 的
wait_timeout（例如 DB 设了60s，Go 端设45 * time.Second） - 不能设太短（如
5s），否则频繁建连开销大；也不能设太长（如1h），否则 DB 先断开，下次复用就报invalid connection - 必须通过
db.DB()获取底层*sql.DB后再调用，不能直接在*gorm.DB上设
典型配置代码片段
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
if err != nil {
panic("failed to connect database")
}
<p>// 必须获取底层 *sql.DB
sqlDB, err := db.DB()
if err != nil {
panic(err)
}</p><p>// 关键三步：最大打开数、最大空闲数、空闲超时
sqlDB.SetMaxOpenConns(100)
sqlDB.SetMaxIdleConns(20)
sqlDB.SetConnMaxIdleTime(45 * time.Second)
注意：SetMaxIdleConns 不能大于 SetMaxOpenConns；PostgreSQL 场景下还要警惕 MaxOpenConns 过大会导致 DB 端 OOM（每个连接约占 10MB 内存）。
容易被忽略的细节
很多人以为设了 SetConnMaxIdleTime 就万事大吉，但实际观察不到效果，大概率是因为：
- 忘了调
SetMaxIdleConns，或者设成了0（连接用完立刻销毁，根本不会空闲） - MySQL 的
wait_timeout和 Go 端值没对齐，导致连接在 Go 还没清理前就被 DB 断开了 - 误把 DSN 中的
timeout当成空闲超时，结果改来改去都没用
空闲连接生命周期这件事，从不自动发生，必须显式配全三个参数，缺一不可。
