Gin 框架本身不提供数据库断开重连机制，重连必须由 database/sql 连接池与业务代码协同实现；db.Ping() 仅验证池中至少一个连接可用，不保证后续分配的连接有效，故 Query 仍可能报 invalid connection；必须设置 SetConnMaxLifetime（小于 DB wait_timeout）、SetMaxOpenConns 和 SetMaxIdleConns 三个参数，并配合幂等性判断、context 超时控制与指数退避的主动重试逻辑。
Gin 框架本身不提供数据库断开重连机制 —— 它只是 HTTP 路由层，重连逻辑必须由 database/sql 连接池 + 业务代码共同实现。 直接依赖 Gin 中间件或路由钩子做“自动重连”是无效的，错误会在 db.Query、db.Exec 等调用时暴露，且 Go 标准库不会自动重试写操作。
为什么 db.Ping() 成功后 Query 还会报 invalid connection
因为 db.Ping() 只验证连接池中「至少一个」连接可用，不刷新其他连接状态，也不影响后续分配行为。MySQL 服务端可能已按 wait_timeout 关闭了某个空闲连接，而 Go 客户端尚未感知 —— 下次从连接池取出该连接执行 db.Query() 就会触发 invalid connection 或 driver: bad connection 错误。
-
db.PingContext(ctx)才受超时控制；db.Ping()在启动重试中必须禁用 - 连接池里每个连接的“出生时间”独立计算，
SetConnMaxLifetime到期后归还时才关闭，与是否 idle 无关 - 即使刚 Ping 成功，高并发下仍可能分配到已失效连接 —— 这不是 bug，是连接池设计使然
必须设置的三个关键连接池参数
仅靠重试不能替代预防。这些参数应在 sql.Open() 后立即设置，且需与数据库服务端配置对齐：
-
db.SetConnMaxLifetime(240 * time.Second)：必须比 MySQL 的wait_timeout（推荐设为 300 秒）小至少 60 秒，强制老化连接提前退役 -
db.SetMaxOpenConns(20)：防止单次突发压垮 DB，也减少空闲连接堆积导致的失效集中爆发 -
db.SetMaxIdleConns(10)：控制空闲连接上限，避免资源浪费；值过大反而增加探活负担
PostgreSQL 用户还需同步调整 tcp_keepalives_idle 等 TCP 参数，否则中间件可能比 DB 更早 kill 连接。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
运行时查询失败怎么安全重试
Go 的 *sql.DB 内置重试仅限 driver.ErrBadConn 场景，且最多 10 次硬编码重试，对主从切换、DNS 变更完全无效。你必须自己封装幂等重试逻辑：
- 只对
SELECT、UPDATE WHERE id = ?等幂等操作重试；INSERT无唯一约束或DELETE无条件禁止重试 - 用
context.WithTimeout(ctx, 2*time.Second)包裹整个重试流程，总耗时不可放任增长 - 退避用指数增长：
100ms → 200ms → 400ms，最多 3–4 次，避免雪崩 - 只捕获明确可重试错误：
driver.ErrBadConn、net.OpError（含"connection refused"）、"i/o timeout"
别在 Gin handler 里裸写 for 循环重试 —— 应抽成独立函数（如 safeQueryRow），并确保错误分类清晰。频繁出现 driver.ErrBadConn 说明 SetConnMaxLifetime 没设对，或 DB 端 wait_timeout 波动未被同步。
启动阶段等待数据库就绪的正确姿势
服务启动时 DB 可能还没 ready（Docker Compose 启动顺序错乱、K8s InitContainer 延迟），此时 sql.Open() 不失败，但第一次 db.PingContext() 必然失败。必须主动等，但方式要克制：
- 只调一次
sql.Open()获取*sql.DB，传给重试函数；绝不循环调用sql.Open - 重试函数内用
db.PingContext(ctx)，ctx必须来自context.WithTimeout(context.Background(), 30*time.Second) - 每次失败后 sleep 指数增长（1s → 2s → 4s），并在 sleep 前检查
ctx.Err() != nil立即退出 - 遇到
"password authentication failed"等认证错误，立刻返回，重试无意义
最易忽略的是：重试逻辑必须和 Gin 初始化解耦 —— 它属于数据访问层初始化范畴，不应混入路由注册或中间件链。连接池参数、重试策略、错误分类，三者缺一不可，少一个就会在流量高峰时暴露脆弱性。
