GORM嵌套事务实为SAVEPOINT语法糖;tx.Begin()在事务中不panic而是创建保存点,inner.Commit()被忽略,RollbackTo()回滚至保存点;需手动Begin()链式调用实现局部回滚,命名须语义化且避免冲突。

GORM 没有真正的嵌套事务,所谓“嵌套”只是 SAVEPOINT 的语法糖;直接在 Transaction() 里再套 Transaction() 会脱离上下文,数据提前落库,原子性失效。
为什么 tx.Begin() 在事务里不 panic 却也不提交
因为 GORM 在已有事务中调用 tx.Begin() 时,底层没走 db.Begin(),而是执行了 SAVEPOINT sp_xxx,并把保存点名记在返回的 *gorm.DB 实例上。这个实例和外层 tx 共享同一数据库连接,只是多了回滚能力。
-
inner.Commit()被 GORM 忽略——保存点不支持“提交”,只支持回滚到它 -
inner.Rollback()实际触发的是ROLLBACK TO SAVEPOINT sp_xxx,不影响外层已做的操作 - 若外层已
Commit()或Rollback(),再操作该保存点会报错(如 PostgreSQL 的current transaction is aborted) - 全局配置了
DisableNestedTransaction: true时,SavePoint()会静默失效,且无 warning
什么时候必须手动用 Begin() 链式调用,而不是 Transaction()
当你需要「局部失败但整体继续」时,Transaction() 就不够用了——它一旦返回 error,整个事务立刻回滚,保存点没机会生效。
- 典型场景:创建用户后同步写入
profile、address、notification_setting;其中address校验失败,只应回滚它,保留user和profile -
Transaction()是一次性闭环,无法中途退出或挂起外层事务 - 正确做法是:
tx1 := db.BeginTx(ctx, nil)启动,之后所有操作都用tx1.Create(),并在关键边界调tx1.SavePoint("sp_address_upsert") - 子操作出错时,调
tx1.RollbackTo("sp_address_upsert"),而非tx1.Rollback()
RollbackTo() 的坑和命名规范
保存点名不是随便起的,命名冲突或复用会导致行为不可预测,尤其在并发请求共用同一事务对象时(比如中间件透传 tx)。
- 重复调用
tx.SavePoint("sp1")会覆盖前一个,RollbackTo("sp1")就跳过中间状态 - 避免在循环里用
uuid.NewString()[:8]动态生成——并发下仍有碰撞风险 - 推荐按业务语义命名:
tx.SavePoint("sp_profile_create")、tx.SavePoint("sp_payment_lock") - 别混用
tx.SavePoint("sp")和原生tx.Exec("SAVEPOINT sp"),容易报no such savepoint
最易被忽略的一点:Begin() 链式调用不自动 recover panic,一旦子操作 panic,外层事务连接卡死,后续请求可能 hang 在 acquire connection timeout;必须自己加 defer + recover,或严格用 error 驱动流程,绝不能依赖 defer tx.Rollback()——它会在成功时误回滚。











