invalid connection 错误不是 GORM 的 bug，而是 MySQL 服务端主动关闭空闲连接后，GORM 底层 *sql.DB 连接池复用了已失效连接所致；核心解法是设对 SetConnMaxLifetime（如240秒，须小于 wait_timeout）、启动时用带超时与指数退避的 PingContext 健康检查、运行时对 SELECT 等幂等操作手动实现重试逻辑。
直接说结论：invalid connection 错误不是 GORM 的 bug，而是 MySQL 服务端主动关闭空闲连接后，GORM 底层的 *sql.DB 连接池复用了已失效连接导致的。核心解法是三件事：设对 SetConnMaxLifetime、启动时带超时重试 PingContext、运行时对读操作做幂等重试。
SetConnMaxLifetime 必须小于 MySQL 的 wait_timeout
MySQL 的 wait_timeout（非交互式连接最大空闲时间）默认是 28800 秒（8 小时），但生产环境普遍设为 300 秒（5 分钟）。如果 GORM 初始化的 *sql.DB 没调 SetConnMaxLifetime，或设为 0 或 ≥ 300 秒，连接就会在服务端关闭后继续被复用，首次 Query 就报 invalid connection。
-
SetConnMaxLifetime是“连接创建后最多活多久”，和是否空闲无关；设为 0 表示永不过期，等于放弃预防 - 推荐值：
db.SetConnMaxLifetime(240 * time.Second)，比 300 秒留出 60 秒缓冲 - 必须在
sql.Open后、Ping前设置，否则无效 - 该配置对所有连接统一生效，不区分 idle 或 busy 状态
启动时 PingContext 要带 context 超时并指数退避重试
db.PingContext 成功 ≠ 数据库就 ready 了。它只验证连接池里至少有一个连接能通，但这个连接可能刚被 MySQL 关闭（只是客户端还没感知），后续 Query 仍会失败。更糟的是，没加 context 的 Ping 会无限阻塞。
- 必须用
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)控制总等待窗口 - 重试间隔用指数退避：1s → 2s → 4s，避免打爆 DB 健康检查端点
- 只对可恢复错误重试：
"dial tcp"、"connection refused"、io: timeout - 遇到
"Access denied"或"Unknown database"这类认证/配置错，应立刻 panic，不重试
运行时 Query 失败要自己写幂等重试逻辑
*sql.DB 内置重试只在 driver.ErrBadConn 下触发，且硬编码最多 10 次，对网络抖动、主从切换、DNS 变更完全无效。GORM 不会帮你自动重连或重放 SQL。
- 只对
SELECT、GET类幂等操作重试；INSERT/UPDATE/DELETE必须结合业务 idempotency key 或事务状态校验 - 用
context.WithTimeout(ctx, 2*time.Second)包裹整个重试流程，防止卡死 - 捕获明确错误类型：
driver.ErrBadConn、net.OpError、"timeout"、"invalid connection" - 别封装全局
SafeQuery函数——它会把 SQL 语法错（如WHERE id == ?）也当连接问题重试，掩盖真实缺陷
GORM 初始化代码里最容易漏掉的三个配置
很多人只写 gorm.Open 就以为完事了，其实 GORM 返回的 *gorm.DB 底层是 *sql.DB，所有连接池控制都得手动透传过去。漏掉任一配置，线上都会周期性报 invalid connection。
- 必须显式拿到
*sql.DB：用db.DB()方法，再调SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime -
SetMaxOpenConns建议设为 MySQLmax_connections × 0.8，防突发打爆 DB -
SetMaxIdleConns设为SetMaxOpenConns / 2左右，避免空闲连接堆积老化失效 - 别信
gorm.Config.PrepareStmt能解决连接失效——它只影响预处理语句缓存，跟连接生命周期无关
真正麻烦的不是配置本身，而是这些设置之间有隐含依赖：比如 SetConnMaxLifetime 设得太小，又没配好 SetMaxIdleConns，会导致连接频繁重建、TLS 握手开销飙升；而设得太大，又会在 MySQL 主动断连后批量失效。线上压测时得盯着连接池指标（idle、inuse、wait count）一起调。
