条件更新返回 0 行:先分清 matched 还是 changed,再判断是不是冲突
现象
带前置条件的更新,写法基本长这样:
UPDATE product
SET title = ?, price = ?, version = version + 1
WHERE id = ? AND version = ?;
返回 0 行。判读时会走向两种错误方向。
一种是把 0 行当冲突。可这次请求只是重新保存了表单,字段值一个都没变;或者 title 被设成它已有的值。行的确匹配上了 WHERE id = ? AND version = ?,只是没有任何列发生实际变化,驱动按“改动行数”回报 0。
另一种是把 0 行当成功。客户端拿到 200,实际上写入根本没落盘:要么行不存在,要么版本已经变了。
这两类问题都出在计数语义上,和乐观锁逻辑本身无关。
0 行的四种含义
同一条 UPDATE 返回 0,可能是下面四种情况之一:
- 行不存在。
id错了、被删了,或tenant_id等授权谓词不匹配。 - 版本不匹配。别的写入者先提交,
version已经推进。这是真正的并发冲突。 - 谓词里的其他条件不成立。例如无版本列的 CAS:
WHERE sku = ? AND stock = 5,库存早就不是 5。 - 行匹配了,但没有实际改动。只有驱动按 changed rows 回报时,这一类才会表现为 0。
前三种是业务含义,第四种是计数口径。混淆这两层,就会出现“用户什么都没改,系统提示保存冲突”。
判据与排查顺序
0 行出现时按这个顺序确认:
- 驱动这次返回的是 matched 还是 changed。这是唯一能解释“第 4 类 0”的原因。
- 守卫语句里有没有
version = version + 1。有,则匹配必然伴随改动,0 只可能表示“没有匹配”;没有,第 4 类 0 随时会出现。 - 守卫谓词是否被绕过。ORM 的
UPDATE是否漏了versionpredicate、bulk update 是否跳过、trigger 是否改了行却没递增version。 - 0 行之后补一次
SELECT,区分“不存在”和“版本冲突”。
各驱动/库的计数口径
| 驱动 / 接口 | 默认口径 | 匹配但无改动 | 切换方式 |
|---|---|---|---|
| MySQL 协议默认 | changed rows | 0 | 设置 CLIENT_FOUND_ROWS |
| mysqli | changed rows | 0 | MYSQLI_CLIENT_FOUND_ROWS |
| PDO MySQL | changed rows | rowCount() 为 0 | PDO::MYSQL_ATTR_FOUND_ROWS => true |
| mysql2(Node) | affectedRows 报 matched,changedRows 报改动 | affectedRows = 1,changedRows = 0 | — |
| Laravel(基于 PDO) | changed rows | 0 | 同 PDO |
mysql_affected_rows() 和 ROW_COUNT() 同样受 CLIENT_FOUND_ROWS 影响:
UPDATE product SET title = 'same' WHERE id = 1 AND version = 6;
SELECT ROW_COUNT(); -- 默认(changed 口径)返回 0
PDO 的开关在构造时给:
// 默认:affected rows == changed rows
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
// 打开后:affected rows == matched rows,no-op 更新返回 1
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::MYSQL_ATTR_FOUND_ROWS => true,
]);
CLIENT_FOUND_ROWS 是连接协商阶段的标志,只能在建连时定,改不了单条语句。这也意味着同一个应用里不同连接可能口径不一致,混用连接池时要留意。
快照读与当前读:比对的不一定是同一份行
SELECT 和 UPDATE 在事务里读的不是同一样东西。一致性读走快照,UPDATE 是当前读,比对的是最新已提交版本。
MySQL 可重复读下:
-- T1
BEGIN;
SELECT version FROM product WHERE id = 1; -- 6,快照在此建立
-- T2: UPDATE product SET version = version + 1 WHERE id = 1 AND version = 6; -- 1 row,version=7
UPDATE product SET title = ? WHERE id = 1 AND version = 6; -- 0 行,真冲突
这个 0 是对的。反过来更麻烦:UPDATE 成功后,同一事务里再 SELECT 拿到的仍是快照中的旧版本,应用会以为自己还持有 6。
需要写入后的新版本时,用 RETURNING(PostgreSQL)或写后单独查一次:
UPDATE document SET body = $2, version = version + 1
WHERE tenant_id = $3 AND document_id = $1 AND version = $4
RETURNING document_id, version;
PostgreSQL 里还有一层:序列化失败(40001)之后当前事务已经废了,重试循环必须放在事务外,同事务内再发 SQL 只会拿到 25P02。
规避写法
让“匹配即改动”成立,是最省事的一条:
UPDATE articles
SET title = ?, body = ?, version = version + 1, updated_at = NOW()
WHERE id = ? AND version = ?;
version = version + 1 必须写在 SQL 里,不能先 $v = $version + 1 再当参数传。否则两个写入者都会算出同一个新版本号。
$stmt = $pdo->prepare(
'UPDATE articles SET title = ?, body = ?, version = version + 1, updated_at = NOW()
WHERE id = ? AND version = ?'
);
$stmt->execute([$title, $body, $id, $expected]);
if ($stmt->rowCount() === 0) {
$cur = $pdo->prepare('SELECT version FROM articles WHERE id = ?');
$cur->execute([$id]);
$row = $cur->fetch(PDO::FETCH_ASSOC);
if ($row === false) {
throw new RuntimeException('article not found');
}
throw new ConflictException((int) $row['version']);
}
因为 version 每次成功更新都必然变化,匹配必然伴随改动,0 行只剩“没有匹配”一种来源。这样即便连接是 changed 口径,也不会把合法保存误判成冲突。
支持无改动保存的场景,要么先读行自己比较,要么直接放行不写。
授权谓词和并发谓词应放进同一个 WHERE:
UPDATE document SET body = $2, version = version + 1
WHERE tenant_id = $3 AND document_id = $1 AND version = $4
RETURNING document_id, version;
两者同时成立才允许写,这样 0 行的含义会比“版本冲突”宽,排查时要分别看。
版本号不要在校验后重置或复用,回退会重新引入 ABA。
API 层语义
版本号每次读都要返回(响应体的 version 字段,或 ETag: "42"),每次写都要带回来。省略版本号的客户端会绕过守卫,守卫也只保护走它的代码路径。
- 版本不匹配 →
409 Conflict If-Match与当前ETag不符 →412 Precondition Failed- 既没带版本也没带
If-Match→428 Precondition Required
409 和 412 可以复用同一个错误体,带上 error code、currentVersion,视权限决定是否附 currentState。
重试要重放“意图”而不是 payload:重读行,把操作(库存加 5)重放到新状态,用新版本写。盲目重试客户端提交的整个对象 PUT,会用旧快照覆盖别人的新行。
DynamoDB 把冲突做成异常:
ConditionExpression = "Version = :expected_v"
不满足时抛 ConditionalCheckFailedException。Java SDK v2 增强客户端可以用 @DynamoDbVersionAttribute 托管版本列。文档:
调用方不同,处理方式也不同:后台任务和计数器可以自动重试(重读、重算、限次、加抖动);人编辑的表单不静默重试,展示当前值让用户合并;API 返回 409 带当前版本,重试与否交给客户端。
取舍
matched 口径少一次读,代价是 no-op 也被算成功;changed 口径对“什么都没改”敏感,配上不带 version = version + 1 的守卫语句就会产生假冲突。选哪个,取决于你的守卫是不是保证每次写入都改行。
检测令牌也有别的选择:整数 version、updated_at 时间戳(有钟偏风险)、字段原值 CAS、ETag/If-Match。SQL Server 用 rowversion。单字段竞争不一定需要版本列,UPDATE inventory SET stock = stock - 1 WHERE sku = ? AND stock = 5 本身就是 CAS。
冲突策略上,fail fast 409、限次重试、三方合并都行;last-write-wins 不是乐观锁,只是没检测。反复冲突到影响体验时,升级成 SELECT ... FOR UPDATE 比继续加重试更直接。
这套写法不适用的地方:需要一次改多行的 bulk update(每行一个版本谓词代价高)、跨表业务约束、以及“用户没改也提交”是常态而你又必须区分冲突的流程——后者要么接受 matched 口径,要么在应用层先做字段级比较再决定发不发 UPDATE。