XORM连接池需协同配置SetMaxOpenConns、SetMaxIdleConns和SetConnMaxLifetime三参数，仅设前两者会导致CLOSED_WAIT堆积；生产推荐SetMaxOpenConns≤150、SetMaxIdleConns为1/3～1/2、SetConnMaxLifetime设为25分钟且小于MySQL wait_timeout。
在Go项目中使用XORM操作MySQL时，连接池配置不当会导致“too many connections”报错、大量CLOSED_WAIT堆积或高并发下请求阻塞。这并非数据库本身容量不足，而是连接生命周期未被正确管控。
理解三个核心参数的协同关系
SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime三者必须同时设置才有效——仅调前两者，连接池仍会持续复用陈旧连接，最终触发MySQL主动断连，客户端残留大量CLOSED_WAIT状态。
SetMaxOpenConns控制池中最大连接总数（含正在使用 + 空闲中），设为0表示无限制，【生产环境严禁设为0】；SetMaxIdleConns控制空闲连接上限，若该值大于SetMaxOpenConns，会被静默截断；SetConnMaxLifetime强制连接到期后关闭，是解决CLOSED_WAIT堆积的唯一有效手段。
MySQL默认wait_timeout=28800秒（8小时），而Go连接若未设SetConnMaxLifetime，在空闲超时后被MySQL单方面断开，下次复用时会报invalid connection错误，并滞留在CLOSED_WAIT状态，直到进程退出。
生产环境推荐配置组合
第一步：确定MySQL服务端最大连接数上限。执行SHOW VARIABLES LIKE 'max_connections';，假设返回值为200，则XORM的SetMaxOpenConns必须严格小于该值，建议取值≤150。
第二步：设定空闲连接数。SetMaxIdleConns应为SetMaxOpenConns的1/3～1/2，例如MaxOpenConns=150时，设为50即可；过低会导致频繁建连开销，过高则空闲连接长期占用DB线程资源。
第三步：强制连接生命周期。SetConnMaxLifetime必须小于MySQL的wait_timeout值，推荐设为25分钟（25 * time.Minute）；若MySQL已调小wait_timeout至300秒，则此处必须设为≤240秒。
第四步：补充连接空闲回收机制（Go 1.15+支持）。调用engine.DB().SetConnMaxIdleTime(10 * time.Minute)，让空闲超时连接更早从池中剔除，避免堆积。
常见错误配置与修正方法
方法一：只设MaxOpenConns和MaxIdleConns，忽略SetConnMaxLifetime
后果：lsof观察到数百ESTABLISHED连接，MySQL重启后大量CLOSED_WAIT残留数小时。
修正：立即补上engine.SetConnMaxLifetime(25 * time.Minute)，并确保MySQL wait_timeout ≥ 30分钟。
方法二：MaxIdleConns > MaxOpenConns
后果：该配置无效，Go标准库会自动将MaxIdleConns截断为MaxOpenConns值，但开发者误以为空闲连接更多，导致连接复用率误判。
提示：始终保证SetMaxIdleConns(n) ≤ SetMaxOpenConns(n)。
方法三：使用已废弃的SetMaxConns()
后果：该方法属于XORM早期版本遗留API，不作用于Go标准库连接池，完全无效。
修正：删除所有engine.SetMaxConns(...)调用，改用engine.SetMaxOpenConns(...)。
验证配置是否生效
启动应用后，执行lsof -i :3306 | grep ESTABLISHED | wc -l，观察稳定连接数是否落在MaxOpenConns设定范围内。
模拟MySQL服务中断再恢复：手动kill mysqld进程，等待30秒后重启；随后观察应用日志是否快速打印invalid connection错误并自动重建新连接——若无报错且连接数不下降，说明SetConnMaxLifetime未生效。
在代码中添加运行时检查：sqlDB := engine.DB(); fmt.Printf("maxOpen: %d, maxIdle: %d, maxLife: %v\n", sqlDB.Stats().MaxOpenConnections, sqlDB.Stats().Idle, sqlDB.ConnMaxLifetime())。
