GORM中事务内必须用Clauses(clause.Locking{Strength:...})显式加锁,且需在db.Transaction中执行;单独调用会因自动提交导致锁立即释放,无效。

事务中必须显式开启,否则锁无效
GORM 的 Clauses(clause.Locking{...}) 不会在自动提交模式下生效。MySQL 会直接忽略 FOR UPDATE 或 LOCK IN SHARE MODE,因为锁在语句执行完就释放了,起不到并发控制作用。
必须用 db.Transaction(...) 包裹整个读+写逻辑,且锁查询和后续操作(如 Save、Update)要在同一个 tx 实例里完成。
- 错误写法:
db.Clauses(...).First(&u)单独调用 → 锁立即释放,其他事务可立刻修改该行 - 正确写法:所有操作都在
tx内,事务提交后才释放锁 - 注意:GORM v2 默认开启
PrepareStmt,但锁语句不走预编译,无需额外关闭
Clauses(clause.Locking{Strength: ...}) 是唯一可靠方式
别拼 SQL 字符串、别用 Raw、别信 gorm:"lock" 这类不存在的标签 —— GORM 不识别,也不会生成带锁的 SQL。
有效值只有两个:
-
clause.LockingStrengthUpdate→ 生成SELECT ... FOR UPDATE -
clause.LockingStrengthShared→ 生成SELECT ... LOCK IN SHARE MODE -
"SHARE"字符串或"SHARED"都会静默失效,必须用常量
示例(更新前加排他锁):
err := db.Transaction(func(tx *gorm.DB) error {
var u User
if err := tx.Clauses(clause.Locking{
Strength: clause.LockingStrengthUpdate,
}).Where("id = ? AND status = ?", 123, "active").First(&u).Error; err != nil {
return err
}
u.Status = "processing"
return tx.Save(&u).Error
})
WHERE 条件必须命中索引,否则锁整张表
这是线上最常踩的坑。InnoDB 行锁的前提是能精确定位到记录。如果 WHERE 字段没索引、用了函数(如 UPPER(name))、或模糊匹配(LIKE "%abc"),InnoDB 就没法走索引扫描,只能全表扫描并给每行加锁 —— 等价于锁表。
- 检查执行计划:
EXPLAIN SELECT ... FOR UPDATE WHERE ... - 确保
type是const、ref或range,不是ALL - 复合条件时,注意最左前缀原则;
status = ? AND id = ?和id = ? AND status = ?在索引设计上效果可能不同
多行加锁必须固定顺序,否则死锁
当一次查多条(比如 IN (?, ?, ?))并准备更新时,不同 goroutine 如果按不同顺序加锁,极易触发 MySQL 的 Deadlock found when trying to get lock (error 1213)。
- 解决方案:统一按主键升序排列 ID 再查询,例如
ORDER BY id - 更稳妥的做法:在事务内先
SELECT id FROM ... ORDER BY id FOR UPDATE拿到有序 ID 列表,再逐条处理 - 避免在锁住 A 后再去查 B 的关联数据再锁 B —— 应提前把所有要锁的 ID 收集齐,一次性加锁
真正难的不是写对语法,而是确认你锁的确实是那几行、且不会被 MySQL 自动升级成范围锁或表锁。每次加锁前,务必看 EXPLAIN 和慢日志里的实际执行计划。











