GORM 账户转账必须用 db.Transaction() 包裹扣减与增加操作并显式校验余额,裸调两次 Save/Update 会导致账务不一致;因无事务保护、无行锁、存在并发写覆盖与幻读风险。

直接说结论:GORM 中完成账户余额转账,必须用 db.Transaction() 包裹整个扣减 + 增加逻辑,并在内部显式校验余额、处理错误;裸写两个 Save() 或 Update() 调用,100% 会出账务不一致问题。
为什么不能分开调用两次 Save/Update
很多人写转账时习惯先查 A 账户余额,判断够不够,再 db.Model(&a).Update("balance", a.Balance-100);接着查 B,再 db.Model(&b).Update("balance", b.Balance+100)。这看起来像转账,实则完全没事务保护:
- 两次 Update 是独立事务(如果没手动开启),中间崩溃或 panic,A 扣了、B 没加,钱就丢了
- 并发场景下,A 查余额是 1000,两个请求同时通过校验,接着都执行扣 100,结果 A 余额变成 800(本该是 900)
-
Update()不校验当前值是否仍是查询时的值,存在“写覆盖”风险
正确做法:用 db.Transaction() 包裹原子操作
db.Transaction() 是 GORM 推荐且最安全的事务入口,它自动处理提交与回滚,异常时无需手动 tx.Rollback()。关键点在于:所有读写操作必须在闭包内完成,且要主动检查业务约束。
- 闭包函数返回
error:非 nil 即触发回滚 - 必须在事务内重新查余额(不能依赖外部缓存值),防止幻读
- 扣款前用
SELECT ... FOR UPDATE加行锁(GORM 默认不加,需显式Unscoped().Where(...).First(&a)+db.Clauses(clause.Locking{Strength: "UPDATE"}),或更简单:用主键查询 +SELECT ... FOR UPDATE语句原生执行) - 示例片段:
err := db.Transaction(func(tx *gorm.DB) error { var from, to Account // 加锁查出发账户(重要!) if err := tx.Clauses(clause.Locking{Strength: "UPDATE"}). Where("id = ?", fromID).First(&from).Error; err != nil { return err } if from.Money
容易被忽略的精度与并发细节
余额字段类型和锁粒度,直接影响系统能否上线:
-
Money必须用decimal(30,2)(数据库) +float64或更优的int64(以分为单位存储),避免浮点数累计误差;GORM 的float64映射在 MySQL 中若未指定 type,可能退化为double,引发精度丢失 - 只锁 from 账户不够——如果多个请求同时转给同一个 to 账户,仍可能因 to 余额校验缺失导致超发(比如 to 是商户结算户,有入账上限)。生产环境应统一按
min(fromID, toID), max(fromID, toID)对账户 ID 排序后加锁,防死锁 -
db.Save()会触发钩子(BeforeSave)、更新UpdatedAt,转账这种纯数值变更,优先用UpdateColumn()或原生 SQL,减少副作用
事务不是加个 Transaction() 就万事大吉。真正卡住人的,永远是锁的范围、余额校验时机、以及 decimal 和 float64 在边界 case 下的隐式转换。跑通单测只是起点,压测时看到重复扣款或负余额,八成是漏了 FOR UPDATE 或用了缓存余额值。











