Revel 框架需手动初始化多个独立 *gorm.DB 实例(如 DBMaster、DBShard1),通过 BEFORE filter 解析请求特征绑定到 c.Params,控制器统一获取并显式传参调用,事务须在同一实例执行。

Revel 框架本身不提供开箱即用的多数据库切换机制,GORM 也不支持运行时替换全局 gorm.DB 实例。直接改 DB 全局变量或在模型里反复调用 db.Session(&session) 是不可靠的——请求并发时会互相覆盖连接,事务也极易错绑到错误库上。
初始化多个独立 DB 实例,别碰全局单例
在 app/init.go 的 init() 或 AppInit() 中,为每个数据库(如主库、分片1、分片2)创建独立的 *gorm.DB 实例,并显式配置连接池与日志:
- 每个实例必须用不同变量名(如
DBMaster、DBShard1),避免复用同一指针 - 务必调用
.SetConnMaxIdleTime()和.SetConnMaxLifetime(),否则连接池可能长期持有过期连接 - 不要省略
.Name()设置(如db.Name("shard1")),后续调试时能快速识别日志来源 - GORM v2 不再需要手动包装
sql.DB,直接传gorm.Config{}即可
用 Revel Filter 绑定请求级 DB 实例到 Context
Revel 的 revel.BEFORE filter 是唯一安全的注入点。你不能依赖中间件返回值或全局上下文变量,而应把选中的 *gorm.DB 实例存入 c.Params 或自定义 c.Application 字段:
- 在 filter 函数中解析请求特征(如 URL path 前缀
/shard1/、Header 中的X-Tenant-ID、或 cookie) - 根据规则匹配到对应 DB 变量(如
DBShard1),然后执行c.Params.Set("db", DBShard1) - 控制器中统一通过
c.Params.Get("db").(*gorm.DB)获取,禁止硬编码DBMaster等全局变量 - 切勿在 filter 中修改
c.Request.Context()并期望模型自动感知——GORM 不读取该 context
模型层必须显式接收 DB 实例,不能依赖全局
所有涉及数据库操作的函数(包括查询、创建、事务)都需把 *gorm.DB 作为参数传入,或封装为方法接收者:
- 错误写法:
User{}.First(&u, 1)—— 它会走 GORM 默认注册的DefaultDB,和你的分片逻辑完全脱钩 - 正确写法:
db.Where("id = ?", id).First(&u),其中db来自c.Params.Get("db") - 事务必须在同个
*gorm.DB实例上调用.Transaction(),跨实例开启事务会导致回滚失效 - 如果用了
revel.InterceptFunc,确保 filter 执行顺序在其他依赖 DB 的 interceptors 之前
最易被忽略的是事务边界和连接复用:同一个 HTTP 请求里,所有 DB 操作必须使用 filter 注入的那一个 *gorm.DB 实例,哪怕只是读一条记录。混用多个实例看似能跑通,但在高并发下会触发连接泄漏、事务丢失或数据写入错库——这些故障往往在线上压测或流量高峰时才暴露,排查成本极高。


















