Revel 项目中应预建命名 DB 实例并注入请求上下文，禁用全局变量硬编码；SQLite 路径需用 os.Executable() 动态构造，模型层须接收 *gorm.DB 参数执行查询，避免并发会话污染。
Revel 项目里执行数据库查询，不能直接用 database/sql 原生句柄裸写，也不该在控制器里临时开连接；核心是把 GORM 实例正确注入请求上下文，并确保模型层能安全拿到当前请求对应的 DB 实例。
初始化 GORM DB 实例时别用全局变量硬编码路径
很多人在 app/init.go 里直接 new 一个 gorm.DB 赋给全局变量，然后在 model 层直接调用 DB.Create()——这在单库场景看似可行，但一旦涉及测试、分库或 SQLite 文件路径变化，立刻出问题。根本原因是：GORM v2 的 *gorm.DB 实例不是线程安全的“单例”，而是带状态的会话对象，其内部 Context 和连接池配置可能被并发请求污染。
- ✅ 正确做法：在
app.Init()中预建多个命名 DB 实例（如DBMaster、DBShard1），但不暴露为包级全局变量；改用 Revel 的revel.AppController或自定义字段挂载 - ⚠️ SQLite 路径必须用
os.Executable()+filepath.EvalSymlinks()构建，否则runtime.Caller(1)返回的是 Revel 内部栈帧，os.Getwd()在revel test下为空，os.Args[0]指向revel.d而非你的二进制 - ? 示例路径构造：
exePath, _ := os.Executable() rootDir := filepath.Dir(filepath.Dir(exePath)) // 通常回到项目根 dbPath := filepath.Join(rootDir, "data", "app.db") gorm.Open(sqlite.Open(dbPath), &gorm.Config{})
控制器中查数据必须走请求绑定的 DB 实例
Revel 的控制器方法（如 func(c App) Index()）默认没有 DB 字段。你不能在方法体内直接调 models.User{}.First()，除非这个模型已显式绑定了当前请求的 *gorm.DB。
- ✅ 推荐方式：写一个
dbFilter拦截器，在revel.BEFORE阶段根据请求参数（如 header、URL path、session）选择对应 DB 实例，存入c.Params.Values或自定义c.DB字段 - ❌ 禁止在 model 层用包级全局
DB变量做查询，否则测试时无法 mock，分库时无法路由，事务也无法跨模型控制 - ? 小技巧：GORM v2 支持
Session(&gorm.Session{Context: c.Request.Context()})创建带上下文的新会话，适合短时操作，但不替代主连接绑定
模型定义要兼容动态 DB 绑定
GORM 模型本身是结构体，不持有 DB 引用；真正执行查询的是调用方传入的 *gorm.DB 实例。所以模型代码里不该出现 DB.First() 这类硬编码。
- ✅ 正确模型写法：
type User struct { ID uint `gorm:"primaryKey"` Name string } // 查询逻辑交给控制器或 service 层，模型只定义结构和约束 func (u *User) FindByID(db *gorm.DB, id uint) error { return db.First(u, id).Error } - ⚠️ 注意
db.First()返回的是*gorm.DB，不是结果；错误必须用.Error显式提取，否则静默失败 - ? 如果要用预加载（Preload），必须在同一个
*gorm.DB实例上调用，跨实例 Preload 会 panic
异步查询别直接 goroutine 包裹 DB 方法
Revel 控制器默认同步执行，有人为提速把 db.Find() 塞进 go func() ——这会导致 *gorm.DB 被多个 goroutine 并发使用，而 GORM 连接池虽线程安全，但会话状态（如 Session、Scopes）不保证并发安全。
- ✅ 安全异步方案：用
revel.InterceptFunc提前在BEFORE阶段完成耗时查询，结果存c.RenderArgs；或改用golang.org/x/sync/errgroup控制并发边界 - ❌ 错误示范：
go db.First(&user)—— user 地址可能被回收，db 会话可能已关闭，error 无法捕获 - ? 关键点：GORM 的
*gorm.DB实例可复用，但每个请求应有独立会话上下文，避免状态泄漏
最易被忽略的是 SQLite 路径解析和 DB 实例生命周期管理——前者错一次，所有环境都打不开库；后者漏一环，测试就跑不通，上线就死锁。别依赖 IDE 启动时的当前目录，也别相信 go run main.go 的行为能迁移到 revel run 或二进制部署上。
