编程 条件更新返回 0 行:先分清 matched 还是 changed,再判断是不是冲突

2026-11-18 00:04:18

条件更新返回 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,可能是下面四种情况之一:

  1. 行不存在。id 错了、被删了,或 tenant_id 等授权谓词不匹配。
  2. 版本不匹配。别的写入者先提交,version 已经推进。这是真正的并发冲突。
  3. 谓词里的其他条件不成立。例如无版本列的 CAS:WHERE sku = ? AND stock = 5,库存早就不是 5。
  4. 行匹配了,但没有实际改动。只有驱动按 changed rows 回报时,这一类才会表现为 0。

前三种是业务含义,第四种是计数口径。混淆这两层,就会出现“用户什么都没改,系统提示保存冲突”。

判据与排查顺序

0 行出现时按这个顺序确认:

  • 驱动这次返回的是 matched 还是 changed。这是唯一能解释“第 4 类 0”的原因。
  • 守卫语句里有没有 version = version + 1。有,则匹配必然伴随改动,0 只可能表示“没有匹配”;没有,第 4 类 0 随时会出现。
  • 守卫谓词是否被绕过。ORM 的 UPDATE 是否漏了 version predicate、bulk update 是否跳过、trigger 是否改了行却没递增 version。
  • 0 行之后补一次 SELECT,区分“不存在”和“版本冲突”。

各驱动/库的计数口径

驱动 / 接口默认口径匹配但无改动切换方式
MySQL 协议默认changed rows0设置 CLIENT_FOUND_ROWS
mysqlichanged rows0MYSQLI_CLIENT_FOUND_ROWS
PDO MySQLchanged rowsrowCount() 为 0PDO::MYSQL_ATTR_FOUND_ROWS => true
mysql2(Node)affectedRows 报 matched,changedRows 报改动affectedRows = 1,changedRows = 0—
Laravel(基于 PDO)changed rows0同 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。

复制全文 生成海报 条件更新 乐观锁 MySQL PDO 并发控制 CAS

推荐文章

程序员茄子在线接单