测试后自动回滚需手动实现,因GORM无内置机制;db.Transaction()会真实提交,不适用于测试隔离;应使用Begin()+defer Rollback()并确保所有操作使用同一事务句柄。

测试后自动回滚不是 GORM 内置行为,必须手动实现;不处理会导致脏数据残留、后续测试失败、CI 环境数据库状态不可控。
为什么 db.Transaction 不适合测试回滚
db.Transaction() 在测试中会真实提交——它设计用于生产环境的原子性保障,不是测试隔离机制。哪怕你 mock 了 DB,只要底层 driver 实际连了测试库,Commit() 就会落盘。
常见错误是写成:
db.Transaction(func(tx *gorm.DB) error {
tx.Create(&user)
return nil // ✅ 没报错 → 自动 Commit()
})
// 测试库 now has a real user
这会让下个测试用到残留数据,尤其当测试并行运行时,结果完全不可预测。
测试中必须用 Begin() + defer Rollback() 组合
真正可靠的测试事务模式是:显式 Begin(),所有操作走该事务句柄,函数退出前无条件 Rollback()(无论成功失败)。
关键点:
- 不能依赖
defer tx.Rollback()单独存在——它会在Commit()后重复执行,但 GORM 允许对已提交事务再调Rollback(),不会 panic,只是日志报 warn;更稳妥的是加标记 - 必须把
tx传给所有被测函数,严禁在事务块里混用db(即未传参的全局 DB 实例),否则操作脱离事务 - 测试数据库连接要独立,比如用
sqlite:file::memory:?cache=shared或每次测试前清空 schema
示例片段:
func TestCreateOrder(t *testing.T) {
db := setupTestDB() // 返回干净的 *gorm.DB
tx := db.Begin()
defer func() {
tx.Rollback() // 总是回滚,不判断 err
}()
err := CreateOrder(tx, Order{Amount: 100}) // 所有内部 DB 调用都用 tx
if err != nil {
t.Fatal(err)
}
}
注意 Context 取消不触发 Rollback
如果测试中用了 context.WithTimeout 并传给 tx.WithContext(ctx),context 超时只会让当前 query 失败,tx 仍处于 open 状态,defer tx.Rollback() 依然有效——这点和生产逻辑一致,但容易误以为“超时=自动清理”。
需要特别留心的边界情况:
- panic 发生在
tx操作中,defer仍会执行,没问题 - 多个 goroutine 共享同一
tx并发操作,GORM 不保证线程安全,测试中应避免 - 使用
Unscoped()的软删除操作,在事务内也受 rollback 控制,无需额外处理
最易被忽略的是:测试数据库没重置或没隔离,导致第一次跑 pass、第二次 fail。自动回滚只是手段,前提是你用的是独占连接或内存库——否则 rollback 成功,数据还在别的连接里活着。


















