GORM事务中行锁必须显式通过Clauses(clause.Locking{Strength: clause.LockingStrengthUpdate})声明,生成SELECT...FOR UPDATE语句;漏写Clauses、Strength写错、非事务调用、WHERE不走索引均导致锁失效或升级为表锁。

事务中用 Clauses(clause.Locking{Strength: clause.LockingStrengthUpdate}) 加行锁
GORM 本身不自动加锁,所有行级锁必须显式声明且严格限定在事务内。直接调用 First() 或 Find() 不会触发任何锁,哪怕加了 WHERE 条件。真正生效的写法只有一种:Clauses(clause.Locking{Strength: clause.LockingStrengthUpdate}),它会生成 SELECT ... FOR UPDATE 语句。
常见错误包括:
- 漏写
Clauses,只写Where().First()→ 完全没锁 - 把
Strength写成"UPDATE"字符串 → GORM 静默忽略,不报错也不加锁 - 在非事务上下文中调用(比如直接对
db而非tx)→ MySQL 自动提交后立即释放锁,形同虚设 - WHERE 条件未命中索引(如
WHERE JSON_EXTRACT(meta, '$.type') = 'vip')→ 可能升级为间隙锁甚至表锁
WHERE 条件必须走索引,否则锁失效风险极高
MySQL 的行锁依赖于索引定位。如果 WHERE 中的字段没索引、或用了函数/表达式/前导模糊匹配,InnoDB 就无法精确定位行,只能退化为扫描并加锁,轻则锁住整个索引范围,重则锁全表。
例如:
-
WHERE id = 123(id 是主键)→ 精确行锁 ✅ -
WHERE email LIKE '%@gmail.com'→ 全表扫描 + 全表锁 ❌ -
WHERE DATE(created_at) = '2026-10-19'→ 索引失效,锁范围不可控 ❌ - 联合索引
(status, user_id),但只写WHERE user_id = 456→ 索引无法使用,可能锁全范围 ❌
务必用 EXPLAIN 确认执行计划中 key 列有值、rows 数量合理。
避免死锁:按固定顺序加锁 + 控制事务粒度
两个事务若以不同顺序更新同一组行(如 A 先锁 ID=1 再锁 ID=2,B 反过来),极易触发 MySQL 死锁(错误码 1213)。GORM 不会帮你做顺序控制,必须由业务层保证。
实操建议:
- 对多行加锁时,统一按主键升序排列后再查询:
WHERE id IN (?, ?) ORDER BY id - 锁操作和后续写操作尽量放在同一个事务里,不要拆成多个事务来回查
- 事务内避免调用外部 HTTP/API,防止事务长时间挂起
- 不要在事务中做复杂计算或循环,锁持有时间越短越好
死锁不是 Go 层面的 panic,它只会作为 error 返回,需主动捕获 strings.Contains(err.Error(), "Deadlock found") 并重试。
共享锁(S 锁)和排他锁(X 锁)不能混用同一行
MySQL 规定:同一行上不能同时存在共享锁和排他锁。如果事务 A 已用 SELECT ... LOCK IN SHARE MODE 锁住某行,事务 B 再用 SELECT ... FOR UPDATE 尝试锁同一行,会被阻塞直到 A 提交或回滚。
这意味着:
- 别在同一个业务流程里交替使用
LockingStrengthShared和LockingStrengthUpdate - 读多写少场景(如配置校验)用共享锁;读完立刻要改的场景(如扣库存)必须用排他锁
- 共享锁之间可以并发,但共享锁和排他锁互斥 —— 这是 MySQL 底层行为,GORM 无法绕过
最容易被忽略的一点:共享锁只防写不防读,它不阻止其他事务再加共享锁;而排他锁既防写也防读(其他事务的共享锁也会被阻塞)。











