Beego数据库连接池需对齐数据库max_connections:SetMaxOpenConns设为60%~80%,SetMaxIdleConns设为1/2~1/3,SetConnMaxLifetime略小于DB超时,并配SetConnMaxIdleTime;事务必须显式Commit/Rollback,Query返回的Rows须手动Close。

Beego 项目里数据库连接池参数设错,不是慢,就是报 too many connections 或 invalid connection;根本不用查 SQL,八成是 SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime 这三个值没对齐数据库真实能力。
查清数据库 max_connections 再动手
硬套“设 100”或“CPU 核数 × 2”是线上翻车第一原因。MySQL 默认 max_connections=151,PostgreSQL 常为 100 或 200,你设 db.SetMaxOpenConns(200),数据库直接拒绝新连接。
- MySQL:执行
SHOW VARIABLES LIKE 'max_connections'; - PostgreSQL:执行
SELECT setting FROM pg_settings WHERE name = 'max_connections'; -
SetMaxOpenConns推荐设为该值的 60%~80%,留余量给后台任务和突发流量 - 观察
db.Stats().OpenConnections:长期 > 90%MaxOpenConns,说明不够用;长期为 0,说明压根没生效
SetMaxIdleConns 和 SetConnMaxLifetime 必须配对调
只调 SetMaxOpenConns 不碰 idle 和 lifetime,等于只装了油没点火——连接池看着在跑,实际一压就崩。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
-
SetMaxIdleConns一般设为SetMaxOpenConns的 1/2~1/3(例如最大开 50,空闲保持 15~25) -
SetConnMaxLifetime必须略小于数据库侧超时设置:MySQL 生产常调wait_timeout=300(5 分钟),你就得设4 * time.Minute - Go 1.15+ 务必加
SetConnMaxIdleTime(5 * time.Minute),防 NAT、LB、防火墙静默断连 - Beego ORM 下需先获取底层
*sql.DB:db, _ := orm.GetDB("default"),再调上述方法
事务不提交,连接就永远卡住
*sql.Tx 本身不等于连接,但它会独占一个连接直到 Commit() 或 Rollback()。忘了调这两个,连接就不会归还池中,db.Stats().OpenConnections 持续上涨,WaitCount 开始飙升。
- 所有
db.Begin()后必须有明确的defer tx.Rollback()+ 显式tx.Commit() - 不能只靠
defer—— 如果Commit()失败,Rollback()也得执行,否则连接泄漏 - 避免在循环里反复
Begin()/Commit():高频小事务不如批量操作 + 单次事务 - 用
db.Stats().WaitCount和db.Stats().WaitDuration监控排队情况,非零即说明连接被长期占用或泄漏
rows.Close() 不是可选项,是强制项
db.Query() 返回的 *sql.Rows 必须显式 Close(),否则连接不会释放回池——这是最隐蔽的连接泄漏来源,比忘关事务还难排查。
- 务必写
defer rows.Close(),且确保它在函数退出前执行 - 如果用了
rows.Next()+rows.Scan()循环,rows.Close()必须在循环结束后立即调用,不能等函数末尾才 defer - Beego ORM 的
All()、One()等方法内部已自动处理,但原生Query()调用必须手动关
真正容易被忽略的是:连接池参数不是设完就完事,它必须和数据库服务端配置、网络中间件(如 LB 超时)、应用并发模型三者对齐;少对一环,就可能在凌晨三点突然冒出 context deadline exceeded。

















