最直接表现是新请求卡在acquireConn或报"timeout: timed out acquiring database connection";需查SHOW PROCESSLIST中Command=Sleep且Time>30s的连接,以及State为Locked或Updating/Writing to net的线程。

查 SHOW PROCESSLIST 看长事务和 Sleep 连接
连接枯竭最直接的表现是新请求卡在 acquireConn 或超时抛出 "timeout: timed out acquiring database connection"。此时别急着调 MaxOpenConns,先连上 MySQL 执行:
SHOW PROCESSLIST;重点关注
Command 列为 Sleep 且 Time 超过 30 秒的连接,以及 State 是 Locked 或长时间停留在 Updating/Writing to net 的线程。这些大概率是未提交事务、显式锁表(LOCK TABLES ... WRITE)或被行锁阻塞的源头。
用 gorm.Session(&gorm.Session{Context: ctx}) 控制事务粒度
GORM 默认不自动开事务,但一旦用了 Transaction 方法,又忘了 defer tx.Rollback() 或没走完 tx.Commit(),连接就会一直被占住——因为 GORM 的事务连接不会归还给连接池,直到事务结束。常见错误包括:
- panic 后没 recover,导致
tx.Rollback()没执行 - 条件分支里只在部分路径调用
Commit(),其余路径静默退出 - 用
db.WithContext(ctx).Transaction(...)但 ctx 被 cancel,GORM 不会自动 rollback(需手动判断ctx.Err() != nil)
建议统一用带 defer 的模板:
err := db.Transaction(func(tx *gorm.DB) error {
// do something
return nil // success → auto commit
// or return errors.New("xxx") → auto rollback
})避免裸写 Begin()/Commit()。
检查 DB.Config.ConnPool 实际状态
GORM v1.23+ 内部用 database/sql 的原生连接池,所以真正起作用的是底层 *sql.DB 对象。你可以从 GORM *gorm.DB 取出它并打印关键指标:
sqlDB, err := db.DB()
if err == nil {
fmt.Printf("Open: %d, InUse: %d, Idle: %d, WaitCount: %d, WaitDuration: %v\n",
sqlDB.Stats().OpenConnections,
sqlDB.Stats().InUse,
sqlDB.Stats().Idle,
sqlDB.Stats().WaitCount,
sqlDB.Stats().WaitDuration)
}如果 InUse == MaxOpenConns 且 WaitCount 持续上涨,说明连接全被占满;若 Idle 很低但 InUse 波动剧烈,可能是短连接没及时释放(比如没用 defer rows.Close())。
锁表操作必须显式配对,且禁用 GORM 自动事务
LOCK TABLES 是会话级独占锁,GORM 的 Transaction 完全不感知它。一旦某处写了:
db.Exec("LOCK TABLES users WRITE")却没跟 db.Exec("UNLOCK TABLES"),这个连接就永远卡死。更危险的是:GORM 在该连接上后续任何操作(包括查询)都会失败,但它仍被算作 “in use”,不会归还池中。解决方式只有两个:
- 绝对避免在业务代码里用
LOCK TABLES,改用行锁(SELECT ... FOR UPDATE)或应用层分布式锁 - 如果真要执行,必须确保在同一
*sql.Conn上完成 lock/unlock,且不用 GORM 的连接池(用db.Conn(context)获取独占连接,操作完conn.Close())
另外,ALTER TABLE、DROP INDEX 等 DDL 在 MySQL 5.7+ 默认加元数据锁(MDL),也会阻塞其他 DML,这类操作不应放在高并发 HTTP handler 中执行。


















