Revel中稳定使用PostgreSQL的核心是控制连接生命周期、实现请求级路由、避免模型层硬编码DB实例;需为每个*gorm.DB显式配置独立gorm.Config,通过filter注入上下文而非全局变量,并在模型方法中显式传入DB实例。

Revel 框架本身不内置数据库驱动,连接 PostgreSQL 必须靠第三方 ORM 或原生 database/sql。在 Revel 项目中稳定用 PostgreSQL,核心不是“能不能连”,而是“怎么让连接生命周期可控、请求上下文可路由、模型层不硬编码 DB 实例”。GORM 是最常用选择,但要注意 Revel 的请求拦截机制和 GORM v2 的连接池管理方式必须对齐。
初始化多个 *gorm.DB 实例时别复用同一个配置变量
很多人在 app/init.go 里写一堆 gorm.Open(),却共用一个 gorm.Config 变量,结果所有连接池参数(比如 MaxOpenConns)被最后调用的覆盖。这会导致某个分片库连接池爆满,另一个却闲置。
- 每个
*gorm.DB实例必须配独立的gorm.Config,哪怕参数相同也要显式构造 - 连接字符串中的
sslmode必须显式指定:sslmode=require(生产)、sslmode=disable(本地开发),不能依赖驱动默认值 - PostgreSQL 的
search_path若非public,得加在连接串里:postgresql://user:pass@localhost:5432/db?search_path=tenant
revel.InterceptFunc 中绑定 DB 到 revel.Ctrl.Params 而非全局变量
常见错误是把选好的 *gorm.DB 存进全局变量(如 CurrentDB),然后在 controller 里直接用——这在并发请求下必然错乱。Revel 的正确做法是利用 filter 把 DB 实例注入当前请求上下文。
- 在 filter 函数里根据请求路径、Header 或 session 决定用哪个 DB,例如:
c.Params.Set("db", DBShard1) - controller 中通过
c.Params.Get("db").(*gorm.DB)获取,类型断言要加 error check - 别在 filter 里做耗时操作(如查 user 表判断租户),否则拖慢所有请求;提前解析 token 或提取 path prefix 更安全
GORM 模型定义时避免依赖全局 *gorm.DB
如果你写 func (u *User) BeforeCreate(tx *gorm.DB) error 这类钩子,并在里面调用 tx.First() 去查关联数据,而这个 tx 来自上层未注入分片逻辑的代码,就会连错库。
- 所有模型方法(包括钩子、Scopes、Callbacks)都应接收
*gorm.DB参数,由调用方传入,而不是从包级变量取 - 封装通用操作时用函数而非方法:例如
GetUserByID(db *gorm.DB, id uint) (*User, error),强制调用者明确传 DB - 慎用
db.Session(&gorm.Session{NewDB: true})—— 它会新建一个无连接池配置的 DB 实例,容易绕过你精心设置的MaxIdleConns
真正难的不是连上 PostgreSQL,而是让每次 HTTP 请求都精准命中该去的库、该用的连接池参数、该生效的 search_path。Revel 的 filter 机制和 GORM 的实例化方式一旦没对齐,问题会藏在并发压测之后才暴露——比如某天突然发现 3% 的请求读到了其他租户的数据。


















