先报告成功、随后爆炸的 upsert
RowsAffected() 统计的是 UPDATE 真正改动的行数,不是 WHERE 匹配到的行数。所以把同样的值再写一遍就是 0,而任何写成「影响行数为 0 就 INSERT」的代码会走「行不存在」那条分支,然后在唯一键上撞 Error 1062。有四种改法:最便宜的是先 SELECT COUNT,最危险的是 DSN 里加 clientFoundRows=true——它会静默改掉进程里所有其它 RowsAffected() 的含义。
这段代码看起来是在防御。它先确认更新有没有生效,再决定要不要插入。它做的恰好相反。
res, _ := db.Exec("UPDATE sites SET site_domain = ? WHERE account_id = ?", domain, accountID)
if n, _ := res.RowsAffected(); n == 0 {
_, err := db.Exec("INSERT INTO sites (account_id, site_domain) VALUES (?, ?)", accountID, domain)
// Error 1062 (23000): Duplicate entry '42' for key 'uk_account_id'
}
那个 0 是从哪来的
四语句,真服务器,2026-11-18:
+---------------+
| affected_rows |
+---------------+
| 0 | <- UPDATE … SET site_domain='example.com' WHERE account_id=42(同值)
+---------------+
+--------------+
| matched_rows |
+--------------+
| 1 | <- SELECT COUNT(*) WHERE account_id=42
+--------------+
+---------------+
| affected_rows |
+---------------+
| 1 | <- 同一个 UPDATE,换成一个真的不同的值
+---------------+
ERROR 1062 (23000) at line 36: Duplicate entry '42' for key 'sites.uk_account_id'
行在——matched_rows = 1——而 UPDATE 仍然说 0。紧接着的 INSERT 失败,因为唯一键正被那行「没被更新」的行占着。
为什么数的是「改动」
MySQL 自己的措辞(C API):不带 CLIENT_FOUND_ROWS 时,UPDATE 的影响行数是真正被改动的行数;带上这个标志,才变成 WHERE 匹配的行数。Go 的驱动把它暴露成 DSN 里的 clientFoundRows=true。
这不是 bug,也不是 Go 的怪癖。这就是你那个 if 正在读的语义。
四种改法,各自代价
| 改法 | 什么时候对 | 代价 |
|---|---|---|
先 SELECT COUNT(*) 再 UPDATE |
必须区分「不存在」与「没变化」 | 每次保存多一次往返 |
INSERT … ON DUPLICATE KEY UPDATE |
纯 upsert,唯一键就是身份 | 需要靠 ROW_COUNT() 才能区分新建/更新 |
SET 里加 updated_at = NOW() |
「被碰过」的语义可接受 | 每次调用都写,包括空写 |
DSN 加 clientFoundRows=true |
整个服务的语义就该是「匹配」 | 同时改掉进程里所有 RowsAffected() |
第二行有个值得知道的细节:upsert 的 ROW_COUNT() 是「插入=1、更新=2、匹配但没变=0」——又是第三种含义。
修一次坏两次的那个
clientFoundRows=true 最诱人:一行改动,失败分支就消失了。它同时静默重写了其它所有 RowsAffected():以「0 行被碰」为条件的缓存失效、只应在真实变化时出现的审计行、把 0 当成丢更新的重试逻辑。
我们没在自己服务上量过这个爆炸半径(见最后一节)。诚实的描述是:它是一次伪装成 DSN 参数的全局语义变更。
怎么知道它真的修好了
- 同一个值连写两次,断言两次都成功,再断言
COUNT(*) = 1。 前半句在原 bug 上是红的;后半句在「有人把唯一键删了」时是红的。 - 制造冲突。 事务里:插入该行 → 用同值走一遍更新路径 → 回滚。一次没有任何重复键可能的绿灯运行,什么都证明不了。
- 按形状 grep,而不是按调用 grep。
RowsAffected()本身没问题;RowsAffected() == 0后面跟INSERT才是 bug。改前改后各数一遍。 - 如果你换了 DSN 标志,所有涉及影响行数的测试都要重跑。这个标志没有局部作用域。
怎么回滚
- 分支逻辑写错:回滚代码,别动 schema。数据没变,回滚就是回到上一个二进制,没别的要恢复。
- 已经写进重复行:那只能说明唯一键也缺了。先去重再加索引,并且留着去重前的 dump——diff 就是你「到底影响了几行」的证据。
- 误开了
clientFoundRows:改回 DSN 字符串即可。它要重启进程,安排好窗口;在途连接会保持旧行为直到被回收。 - 每次调用都写
updated_at:对数据无害,但对 binlog 和审计很吵。如果你是拿它当修复手段、后来又撤了逻辑,把这个列写入也一起去掉,否则每次保存看起来都「改过」。
我们没验的三件事
- 一个大型 Go 服务里有多少处是这个形状。 我们是靠事故发现的,不是靠审计;真数要么做 AST 遍历,要么没有。
clientFoundRows在生产上的爆炸半径。 我们是读驱动文档 + 翻自己的调用点得出的「危险」,并没有在运行中的系统上量过。ON DUPLICATE KEY UPDATE与生成列一起用会不会出问题。 我们那张软删表现在有生成列了,但还没在这个组合上重跑 upsert。
如果只看一句:RowsAffected() 回答的是「这次有没有改动」,而你那个 upsert 需要的是「这一行存不存在」。这是两个问题,数据库不会告诉你你问的是哪一个。可运行的复现在这个仓库里。
相关档案
常见问题
行明明在,为什么 RowsAffected 返回 0?
因为 MySQL 统计的是被修改的行,不是被匹配的行。写入同样的值什么都没改,所以是 0——尽管 WHERE 已经找到了那一行。带上 CLIENT_FOUND_ROWS 时,同一次调用才会返回匹配数。
INSERT … ON DUPLICATE KEY UPDATE 总是更好吗?
当操作确实是「插入或覆盖」、且唯一键就是身份时更好。当你需要区分「新建」与「更新」用于审计或事件时更差——upsert 形式把这个信息丢了。
打开 clientFoundRows 会坏什么?
进程里每一个 RowsAffected() 的含义同时改变。所有用「0 表示没碰到行」的地方——软标记、缓存失效、审计日志——会在空写入时悄悄开始触发。
怎么知道真的修好了?
同一个值连写两次,断言两次都成功,然后断言表里只有一行。前半句抓 RowsAffected 语义,后半句抓重复插入。一个测试,两种失败模式。
来源
本文最后一次核验:2026-11-18 · 2026-11-18 在 MySQL 8.4.13(Ubuntu 26.04 / WSL)上复现:同值 UPDATE 的 affected_rows 为 0 而 COUNT(*) 为 1,真实修改返回 1,重复 INSERT 报 ERROR 1062 且键名带表前缀。