innodb_lock_wait_timeout是MySQL服务端参数,决定锁等待超时时间,默认50秒;GORM或Go的context.Context对其完全无效,因锁等待发生在SQL层而非网络层;需通过SET GLOBAL/SESSION或配置文件修改,且应配合NOWAIT、索引优化等根治锁竞争。

MySQL 的 innodb_lock_wait_timeout 是全局开关,不是 GORM 能覆盖的
事务里执行 SELECT ... FOR UPDATE 卡住时,真正决定“等多久就放弃”的是 MySQL 服务端配置 innodb_lock_wait_timeout(默认 50 秒),GORM 或 Go 的 context.Context 对这个等待过程**完全不生效**。哪怕你传了 context.WithTimeout(ctx, 2*time.Second) 给 db.BeginTx(),只要锁没拿到,Go 层依然会干等满 50 秒才收到 MySQL 返回的 Lock wait timeout exceeded 错误。
这是因为:锁等待发生在 SQL 层,而 context 超时只作用于网络读写和语句执行阶段——它无法中断 MySQL 内部的锁等待队列调度。
- 验证方式:在 MySQL 中执行
SELECT @@innodb_lock_wait_timeout,或用SHOW VARIABLES LIKE 'innodb_lock_wait_timeout' - 修改需 DBA 权限:
SET GLOBAL innodb_lock_wait_timeout = 5(重启失效)或会话级SET SESSION innodb_lock_wait_timeout = 5 - GORM 的
WithContext()、db.Transaction()对该超时值零影响
用 SELECT ... FOR UPDATE NOWAIT 避开锁等待
MySQL 8.0.1+ 和 PostgreSQL 原生支持 NOWAIT,它让锁请求立即失败而不是等待,这时 context 才真正可控——因为错误立刻返回,ctx.Err() 检查能起作用。
示例(MySQL 8.0.1+):
err := db.Transaction(func(tx *gorm.DB) error {
var product Product
// 立即失败,不等待
if err := tx.Clauses(clause.Locking{
Strength: "UPDATE",
Options: "NOWAIT",
}).First(&product, 123).Error; err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) ||
strings.Contains(err.Error(), "Lock wait timeout") ||
strings.Contains(err.Error(), "Lock wait timeout exceeded") ||
strings.Contains(err.Error(), "Lock wait timeout exceeded") {
return fmt.Errorf("product locked: %w", err)
}
return err
}
product.Stock--
return tx.Save(&product).Error
})
-
NOWAIT不是标准 SQL,SQLite/旧版 MySQL 不支持 - PostgreSQL 写法一致,但错误信息关键词是
could not obtain lock on row - 必须配合
context.WithTimeout使用才有意义:NOWAIT 让错误变快,context 让上层能统一兜底
GORM 中显式控制锁行为的 Clauses 用法
clause.Locking 是 GORM 控制锁语义的唯一标准接口,不要用 Set("gorm:query_option", "FOR UPDATE") 这类非类型安全写法——它绕过 GORM 的 SQL 构建逻辑,容易在预编译、日志、钩子中丢失上下文。
正确写法包括:
- 悲观写锁:
Clauses(clause.Locking{Strength: "UPDATE"}) - 悲观读锁:
Clauses(clause.Locking{Strength: "SHARE"}) - 带 NOWAIT:
Clauses(clause.Locking{Strength: "UPDATE", Options: "NOWAIT"}) - PostgreSQL 的 SKIP LOCKED:
Clauses(clause.Locking{Strength: "UPDATE", Options: "SKIP LOCKED"})
注意:Strength: "UPDATE" 在 MySQL 下等价于 FOR UPDATE,但不会自动加 WAIT n ——GORM 根本不生成这个子句,也不建议手拼,因为 WAIT 是 MySQL 8.0.26+ 才支持的语法,且与 NOWAIT 互斥。
超时后必须手动 Rollback,不能依赖 defer
context 超时触发 ctx.Err() 后,tx.Commit() 和 tx.Rollback() 仍可调用成功,但事务状态已不可信。常见错误是只写 defer tx.Rollback(),结果超时后 tx.Commit() 还被执行了。
正确模式是:
ctx, cancel := context.WithTimeout(db.Config.Context, 3*time.Second)
defer cancel()
<p>tx := db.WithContext(ctx).Begin()
if tx.Error != nil {
return tx.Error
}
defer func() {
if r := recover(); r != nil {
tx.Rollback()
}
}()</p><p>// 业务操作...
if err := tx.Clauses(...).First(&p, id).Error; err != nil {
if errors.Is(ctx.Err(), context.DeadlineExceeded) {
tx.Rollback() // 显式回滚
return fmt.Errorf("lock timeout: %w", err)
}
return err
}</p><p>return tx.Commit().Error
</p>
关键点:每次查询/执行后都检查 ctx.Err(),一发现超时就立刻 tx.Rollback() 并返回,别等 defer。











