pop.Transaction中间件仅对HTTP请求生效,单元测试中直接调用handler会绕过它;必须手动用c.Value("tx").(*pop.Connection)执行DB操作,并确保测试使用sqlite3://:memory:或显式事务连接。

pop.Transaction 中间件只对 HTTP 请求生效,不覆盖单元测试
很多人以为在 app.Use(popmw.Transaction(app.Pop)) 之后,所有 handler 都自动包裹在事务里、失败就回滚——这是错觉。这个中间件只在 HTTP 请求生命周期中起作用,比如你用 curl 或浏览器访问 /users,事务才会被开启和(隐式)回滚。但如果你写单元测试时直接调用 UsersList(c),整个调用链绕过了 HTTP 栈,中间件根本不会触发。
常见错误现象:buffalo test 后发现开发库数据被插入或修改;或者测试报错 connection refused(其实是连了 PostgreSQL 而非内存 SQLite)。
- 必须确认测试运行时显式指定环境:
buffalo test -e test或go test -tags=test ./actions - 确保
models.NewDB()对"test"环境返回sqlite3://:memory:或带事务能力的连接 - 不要依赖
database.yml中的test:块——Buffalo 不读它,models.go才是唯一可信入口
handler 内部必须用 *pop.Connection 实例操作数据库
即使启用了 popmw.Transaction,如果 handler 里写了 app.DB.Create(&u),事务依然会“漏出”。因为 app.DB 是全局连接,不参与当前请求绑定的事务上下文;真正该用的是从 context 拿到的 c.Value("tx").(*pop.Connection),或更稳妥地:在 handler 开头加 tx, _ := c.Value("tx").(*pop.Connection)。
否则,Create() 直接落库,事务中间件 rollback 的只是它自己开的那个空事务,对实际写入毫无影响。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
- 所有 DB 操作必须基于
tx实例:用tx.Create()、tx.Find()、tx.ValidateAndSave() -
ValidateAndSave()必须代替Create(),否则模型验证失败不会抛错,静默失败 - 避免在 handler 里调用任何直接使用
app.DB的 service 函数,除非它们也接收*pop.Connection参数
事务回滚不等于数据完全干净,SQLite :memory: 更可靠
pop.Transaction() 底层依赖数据库对 ROLLBACK 的支持,而 SQLite 的 :memory: 模式不支持嵌套事务,PostgreSQL/MySQL 则没问题。但即便在 PG 上,若 handler 中混用 db.Exec() 或 raw SQL 且未走 tx,那些语句也不会被回滚。
更隐蔽的问题:某些第三方库(如日志记录器、审计钩子)可能在 handler 执行中途偷偷连了新连接写表,这些完全游离于事务之外。
- 单元测试优先选
sqlite3://:memory::进程内隔离、启动快、100% 干净,适合验证逻辑 - 集成测试若需真实 DB,务必用 Docker 起临时容器,并确保所有 DB 操作都显式传入同一
tx - 别指望中间件“自动兜底”——事务边界必须由你手动对齐 handler 入口、DB 操作、错误分支
如何验证事务是否真正在回滚
最简单的验证方式:在 handler 末尾加一行 panic("force rollback"),然后发一个请求,再查数据库。如果数据没写入,说明事务生效;如果还在,说明有操作绕过了 tx。
另一个信号是日志:启用 pop.Debug = true 后,你会看到类似 START TRANSACTION → INSERT ... → ROLLBACK 的完整链条。如果只有前两行,没有 ROLLBACK,基本可以断定事务没被正确捕获。
- 检查日志输出中是否有
ROLLBACK,而不是只看有没有START TRANSACTION - 在 handler 中打印
c.Value("tx"),确认不是nil - 避免在中间件顺序中把
popmw.Transaction放在太后面——它必须在其他可能提前 return 的中间件之前
*pop.Connection;一旦漏掉一个,整条链路就失效了。


















