不能在Fiber handler中每次调用gorm.Open创建新DB实例,因为每个gorm.Open都会新建独立gorm.DB及底层sql.DB连接池,导致连接泄漏、too many connections或fd耗尽;GORM设计要求全局复用预初始化的少数实例。

为什么不能在 Fiber handler 里每次调 gorm.Open 创建新 DB 实例
直接在 func(c *fiber.Ctx) error 中反复调用 gorm.Open 会导致连接池无限泄漏——每个 gorm.Open 都会新建一个独立的 *gorm.DB,而其底层 *sql.DB 连接池不会自动复用或销毁。实际压测中常出现 too many connections 或 fd 耗尽。GORM 的设计本意是全局复用单个(或少数几个)预初始化的 *gorm.DB 实例,而非按请求 new。
推荐做法:启动时初始化 DB 实例并注入 Fiber App
把数据库连接池当成应用级资源,在 main() 启动阶段完成初始化,并通过 Fiber 的 App.Use 或自定义中间件注入上下文。关键点:
-
gorm.Open只调一次,传入&gorm.Config{PrepareStmt: true}提升重复 SQL 性能 - 显式配置连接池:
db.Config.ConnPool.(*sql.DB).SetMaxOpenConns(100)和SetMaxIdleConns(20) - 用
app.Get("/user", func(c *fiber.Ctx) error { db := c.Locals("db").(*gorm.DB); ... })从上下文取实例,避免全局变量污染 - 不依赖
revel.InterceptFunc(那是 Revel 的机制,Fiber 用app.Use或c.Context().SetUserValue)
多库场景下怎么安全切换(如主从/分片)
Fiber 没有内置“请求路由到指定 DB”的 filter 机制,必须手动实现上下文绑定。常见错误是把 DBMain/DBShard1 直接塞进全局变量再靠 if 切换——这在并发下极易错乱。正确路径:
- 启动时预建多个
*gorm.DB实例(DBMaster,DBReplica,DBShardA等),各自独立配置连接池 - 写一个中间件,根据 URL path、header 或 query 参数决定用哪个库,例如:
if strings.HasPrefix(c.Path(), "/api/shard/") { c.Locals("db", DBShardA) } - 模型层统一从
c.Locals("db")取实例,禁止硬编码调用全局 DB 变量 - 注意事务必须在同一个
*gorm.DB实例内完成,跨库Transaction()无效
连接健康检查和自动重连容易被忽略
GORM v2 不会自动重连失效连接,db.Exec("SELECT 1") 失败后仍可能返回旧的坏连接。生产环境必须加兜底:
- 定期调用
db.Exec("SELECT 1").Error做探活(建议用 goroutine 每 30s 一次,别阻塞请求) - 捕获
driver.ErrBadConn并触发db.Callback().Create().Replace("gorm:create", ...)自定义重试逻辑 - 不要依赖
db.Statement.ConnPool.Ping()—— 它只检测连接池是否存活,不保证后续 Query 能成功


















