lockForNoKeyUpdate。该方法是 Laravel 13.x 的 Query Builder 新增的,在 PostgreSQL 中会生成 FOR NO KEY UPDATE。
本页基于 Laravel Framework 13.x 的实现。请确认
13.x 分支中新增的功能已包含在你使用的版本中。与 lockForUpdate 的区别
Laravel 官方文档介绍了使用 sharedLock 和 lockForUpdate 的悲观锁。lockForNoKeyUpdate 增加了另一种可以通过 Query Builder 通用 API 选择的锁模式。
FOR NO KEY UPDATE 并不意味着所有操作都能无阻塞地进行。只有在较弱的更新锁合适时才使用它,并确认你实际使用的数据库的事务边界和锁行为。
在事务中使用
在同一个事务中获取悲观锁并执行更新。在下面的示例中,准备并写入余额更新期间,用户行始终处于锁定状态。lockForUpdate 的建议,将操作包裹在事务中,可以让获取的数据在操作完成之前一直受到保护。DB::transaction 在回调正常返回时提交,在回调抛出异常时回滚。
lockForNoKeyUpdate 只是给 select 查询添加锁子句。它不会自动执行更新,也不会禁用外键约束。
各数据库的生成结果
Query Builder 会向连接的 grammar 请求锁的值。在 Laravel Framework 13.x 的实现中,只有 PostgreSQL grammar 返回for no key update。
例如,PostgreSQL 连接会生成如下 SQL。绑定参数的处理与其他 Query Builder 查询相同。
lockForNoKeyUpdate 本身不会失败。但它与 PostgreSQL 的 FOR NO KEY UPDATE 含义并不相同:MySQL 和 SQL Server 会将其编译为各自的普通更新锁,而 SQLite 不输出锁子句。
Framework 内部的处理
该方法不在 Query Builder 中按数据库驱动分支,而是将锁的选择委托给连接的 grammar。Builder::lockForNoKeyUpdate()调用grammar->getNoKeyUpdateLock()。- 基础
Grammar返回true,表示回退为普通更新锁。 PostgresGrammar返回字符串for no key update。compileLock原样使用字符串值;布尔回退如何编译由各个 grammar 决定。
从现有悲观锁迁移
替换现有的lockForUpdate 调用时,不要只修改方法名。请确认以下所有事项:
- 该操作确实需要不阻塞外键检查的锁。
- 生产环境的连接使用 PostgreSQL。
- 在 MySQL 或 SQL Server 上回退为普通更新锁是可以接受的。
- 获取锁、更新和提交在同一个事务中完成。
- 对多行获取现有锁的顺序保持一致。
method_exists 检查可能会掩盖语义上的变化:用户可能期望 PostgreSQL 的行为,而其他驱动执行的却是普通的 FOR UPDATE 锁。