事务回滚必须用 db.Transaction() 启动,不能直接调用 db.Begin();它自动处理提交/回滚,仅当函数返回非 nil error 时才回滚,且所有操作必须使用参数 tx 实例。

事务回滚必须用 db.Transaction() 启动,不能直接调用 db.Begin()
很多人误以为先 db.Begin() 拿到 *gorm.DB 实例再操作就能控制事务,结果发现 Rollback() 不生效——这是因为 GORM 的事务上下文不通过裸 DB 实例传播。真正可靠的入口只有 db.Transaction(),它自动处理提交/回滚,并在 panic 或返回非 nil error 时强制回滚。
实操建议:
-
db.Transaction()接收一个函数,该函数参数是事务专属的*gorm.DB实例,所有数据库操作必须在这个实例上进行 - 函数内任意位置返回
error(包括fmt.Errorf、errors.New等),事务都会自动回滚 - 不要在函数外捕获 panic 并“手动 recover”,否则会绕过 GORM 的回滚逻辑
- 如果需要自定义错误类型判断是否回滚,应在函数内显式
return err,而非依赖 panic
回滚触发条件只看函数返回值,和 SQL 错误无关
GORM 不会自动检测底层 SQL 执行失败就回滚。比如你执行一条违反唯一约束的 CREATE,GORM 可能返回 ErrRecordNotFound 或具体数据库错误(如 ERROR: duplicate key value violates unique constraint),但只要你的事务函数没返回 error,GORM 就照常 Commit()。
常见错误现象:
立即学习“go语言免费学习笔记(深入)”;
- 插入失败但事务仍提交 → 忘记检查
Save().Error并 return - 多个操作中某一步失败,后续还继续执行 → 应该用 if 判断每个操作的 error 并提前 return
- 用
FirstOrInit()或Find()查不到数据就认为出错 → 这些方法本身成功时也返回nilerror,需额外判断记录是否存在
示例关键片段:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
err := db.Transaction(func(tx *gorm.DB) error {
if err := tx.Create(&user).Error; err != nil {
return err // ← 这里 return 才触发回滚
}
if err := tx.Create(&profile).Error; err != nil {
return err // ← 第二步失败,user 也不会存进去
}
return nil // ← 全部成功才提交
})
嵌套事务不生效,GORM 只认最外层 Transaction()
GORM 不支持真正的嵌套事务(savepoint)。如果你在 Transaction() 函数内部又调用一次 tx.Transaction(...),第二个调用只是复用当前事务上下文,不会新建 savepoint;即使它内部 return error,也不会回滚到嵌套点,而是连同整个外层一起回滚。
使用场景与替代方案:
- 想局部失败不影响整体?别嵌套事务,改用业务逻辑分段 + 显式 error 分发
- 需要部分回滚(比如 A/B 两个子操作,A 失败要回滚 A,B 失败只回滚 B)?GORM 做不到,得换原生
sql.Tx+SavePoint(PostgreSQL/MySQL 8.0+ 支持) - 日志或审计类写入想“尽力而为”不拖累主事务?用独立 DB 实例(非事务上下文)异步写,或延迟到事务提交后再触发
测试时容易忽略:事务函数内不能用全局 db 实例
事务函数里的 tx 是隔离的,它和外部 db 不共享状态。如果你在函数里误用了 db.Create() 而不是 tx.Create(),那这条语句根本不在事务中,会立即提交,导致数据残留、测试断言失败。
容易踩的坑:
- 复制粘贴代码时忘了把
db替换成tx - 调用封装好的 service 方法,而该方法内部硬编码用了全局
db→ 需改造 service,接受*gorm.DB作为参数 - 用
db.WithContext(ctx)包装后传入事务函数,但 ctx 里带了其他中间件注入的 DB 实例 → 一律以函数参数tx为准
最稳妥做法:事务函数体内所有 DB 操作,都从参数 tx 开始链式调用,例如 tx.Where(...).First()、tx.Model(...).Updates()。
Transaction() 函数内使用传入的 tx 实例、是否对每一步 DB 操作的 error 做显式判断并 return。任何绕过这两点的操作,都会让回滚失效,且很难在测试中暴露。

















