SELECT ... FOR UPDATE 在 GORM 中不自动生效,因为 GORM 的 Find/First 等查询不透传锁语义,必须显式在事务内通过 Clauses(Locking) 或 Raw 执行,且依赖数据库支持与正确隔离级别。

为什么 SELECT ... FOR UPDATE 在 GORM 中不自动生效
GORM 默认的 Find、First 等查询不会加锁,哪怕你写了 SELECT ... FOR UPDATE 原生 SQL,GORM 也可能在事务外执行或忽略锁提示。根本原因是:GORM 的查询构造器不把锁语义当“一等公民”,FOR UPDATE 必须显式触发,且依赖底层数据库支持和事务上下文。
常见错误现象包括:
- 调用
db.Where("id = ?", 1).First(&user)后直接更新,结果发生并发覆盖 - 手动拼接
"SELECT * FROM users WHERE id = ? FOR UPDATE"但没在事务中执行,锁立即释放 - 用
Session(&gorm.Session{PrepareStmt: true})试图复用语句,却忘了锁只在事务内有效
用 Session + Unscoped 组合实现行级锁定
GORM v2 提供了 Session 方法控制查询行为,配合 Unscoped 可绕过软删除干扰,但真正起作用的是 WithContext 绑定事务上下文。锁必须在开启事务后、执行查询前就声明。
正确做法是:
- 先用
db.Begin()或db.Transaction()获取事务句柄 - 在该事务对象上调用
Session(&gorm.Session{DryRun: false})(无需 DryRun,这里只是强调非模拟) - 使用
Raw或Scan执行带FOR UPDATE的语句,例如:tx.Raw("SELECT * FROM users WHERE id = ? FOR UPDATE", 1).Scan(&user) - 避免用
First等高级方法——它们不透传锁提示
注意:MySQL 支持 FOR UPDATE,PostgreSQL 需写成 FOR UPDATE OF users 或加 SKIP LOCKED 防死锁;SQLite 不支持行锁,会退化为表锁。
LockingClause 是 GORM v2.2+ 的官方方案,但有兼容陷阱
GORM v2.2 引入了 LockingClause 方法,看起来更“ORM”: db.Clauses(clause.Locking{Strength: "UPDATE"}).First(&user, 1)。但它背后仍生成 FOR UPDATE,且仅在事务中生效。
容易踩的坑:
- 未开启事务时调用,MySQL 可能静默忽略锁,PostgreSQL 报错
ERROR: LOCK TABLE can only be used in transaction blocks -
Strength: "UPDATE"在 PostgreSQL 中对应FOR UPDATE,但若涉及多表关联,需显式指定Tables字段,否则锁可能不生效 - SQL Server 用户得用
Strength: "HOLDLOCK",不能照搬 MySQL 写法
示例(安全写法):
err := db.Transaction(func(tx *gorm.DB) error {
if err := tx.Clauses(clause.Locking{
Strength: "UPDATE",
}).First(&user, 1).Error; err != nil {
return err
}
user.Status = "processing"
return tx.Save(&user).Error
})
乐观锁比 FOR UPDATE 更适合高并发读场景
当冲突概率低、业务允许重试时,用版本号(Version 字段)做乐观锁,比阻塞式行锁吞吐更高。GORM 原生支持:只要结构体含 Version uint 字段,Save 会自动带上 WHERE version = ? 条件。
关键点:
- 不需要事务包裹,也不依赖数据库锁机制
- 更新失败时捕获
RowsAffected == 0,而非错误,然后重试逻辑由你控制 - 注意时钟不同步不影响它,但要防止用户长时间编辑后提交——需加前端时间戳校验或自动续期
悲观锁(FOR UPDATE)真正在意的是“不能有中间状态”,比如库存扣减、订单支付确认;而乐观锁适用于“最终一致即可”的场景,比如文章点赞数、用户积分变更。
锁不是银弹,FOR UPDATE 拿太久会导致连接堆积,SKIP LOCKED 和合理索引才是高并发下的实际解法。


















