Beego数据库连接泄漏本质是连接借出未归还，导致InUse持续上涨、Idle长期为0，最终请求阻塞；根本原因在于ORM中rows.Close()被忽略、误关全局db池或事务未正确结束。
Beego 项目中数据库连接泄漏不是“连不上”，而是连接被借出后没归还，InUse 持续上涨、Idle 长期为 0，最终导致新请求阻塞或超时。根本原因往往不在 SQL 本身，而在连接生命周期管理失当。
beego ORM 中 rows.Close() 被忽略的典型场景
beego 的 orm.QuerySeter（如 o.QueryTable("user").Filter(...).All()）底层调用的是 *sql.Rows，但其 All()、Values()、ValuesList() 等方法**不会自动关闭底层 rows**——这是最隐蔽也最常踩的坑。
- 错误写法：在 controller 方法里直接
qs.All(&users)后无任何清理动作，尤其当后续逻辑 panic 或提前 return 时，rows 永远不释放 - 正确做法：显式调用
defer qs.Close()（注意：不是o.Close()），且必须放在qs创建后立即 defer - 更安全替代：优先使用
QueryRow或Read等只返回单值的方法，它们内部已封装连接回收逻辑 - 特别注意：若用
Raw()执行查询，必须手动调rows.Close()；Raw().Exec()则无需
全局 db 实例误关或重复初始化
beego orm 的 orm.RegisterDataBase 注册的是连接池句柄，不是单次连接。误操作会直接废掉整个池。
-
defer orm.NewOrm().Db.Close()写在 handler 入口？立刻删掉——这等于每请求都关一次池，后续所有 DB 操作全失败 - 在每个 controller 或 service 里反复调
orm.NewOrm()并认为它“轻量”？没问题，但若你在里面又调了o.Db.SetMaxOpenConns(5)，不同实例互相覆盖配置，池行为不可控 - 正确姿势：只在
init()或main()初始化一次orm.RegisterDataBase，之后所有orm.NewOrm()返回的都是复用同一池的句柄 - 验证方式：打印
orm.Debug = true后看日志，若出现大量sql: database is closed，基本就是误关池了
事务未结束导致连接卡死
beego orm 的事务对象 tx := o.Begin() 是有状态的：只要没调 tx.Commit() 或 tx.Rollback()，底层连接就不会归还池子。
- 常见漏点：事务内用了
tx.QueryTable(...).All()，但只写了tx.Commit()，忘了defer tx.Close()（实际应 defertx.Rollback()配合手动 commit） - 更危险的是：事务中执行了
tx.Raw().Rows()却没关rows，此时即使Commit()成功，连接仍被 rows 持有 - 建议统一模板：
tx := o.Begin() defer func() { if r := recover(); r != nil { tx.Rollback() } }() if err := doSomething(tx); err != nil { tx.Rollback() return err } return tx.Commit()
如何用 db.Stats() 实时盯住泄漏苗头
别等线上报错才查。beego 底层 orm.Ormer 可通过 o.Db.DB().Stats() 拿到原生 *sql.DB 统计信息，这是最直接的观测入口。
- 关键字段含义：
-
InUse：当前被占用的连接数。持续 >MaxOpenConnections * 0.8且不回落 → 立刻检查rows.Close()是否遗漏 -
Idle：空闲连接数。长期为 0 → 不是池太小，就是连接借出后根本没释放 -
WaitCount：累计等待连接次数。非零且每分钟增长 → 连接池容量不足或泄漏已开始影响吞吐
-
- 实操建议：在健康检查接口（如
/healthz）里直接返回o.Db.DB().Stats()，用 Prometheus 抓取并设告警，例如InUse > 18（当SetMaxOpenConns(20)时） - 注意：beego v2 的
orm.NewOrm()返回的Ormer对象没有暴露Db()方法，需先转成*gorm.DB（若用 GORM）或改用orm.DefaultOrmer().Db.DB().Stats()
连接泄漏最难调试的地方在于：它不报错，只缓慢恶化。InUse 每小时涨 1–2，可能要一两天才压垮服务；而修复的关键，永远是那一行被遗忘的 rows.Close()，而不是调大 SetMaxOpenConns。
