MySQL 的 RowsAffected 不是「匹配行数」
UPDATE 返回的是真正改动的行数,不是匹配的行数。写成 if affected == 0 { INSERT } 就是一颗 1062 炸弹,这里给出四种改法。
它解决什么
重复写入同一个值时 UPDATE 返回 0 行,代码据此认为「行不存在」而去 INSERT,撞上 Error 1062。
出问题的写法看着毫无异常:
res, _ := db.Exec("UPDATE sites SET site_domain = ? WHERE account_id = ?", domain, accountID)
if n, _ := res.RowsAffected(); n == 0 {
db.Exec("INSERT INTO sites (account_id, site_domain) VALUES (?, ?)", accountID, domain)
// Error 1062 (23000): Duplicate entry '42' for key 'uk_account_id'
}
行是存在的,只是值没变,于是 MySQL 报「影响 0 行」,代码判定「行不存在」,去插入,撞唯一键。
为什么
RowsAffected() 返回的是真正被改动的行数。MySQL 官方 C API 文档写得很清楚:默认统计被改动的行,带 CLIENT_FOUND_ROWS 时才统计 WHERE 匹配的行。Go 的驱动把这个开关暴露成 DSN 里的 clientFoundRows=true。
四种改法
| 改法 | 什么时候对 | 代价 |
|---|---|---|
先 SELECT COUNT(*) |
必须区分「不存在」与「没变化」 | 多一次往返 |
INSERT … ON DUPLICATE KEY UPDATE |
纯 upsert,没有其它逻辑 | 需要唯一键 |
SET 里加 updated_at = NOW() |
「被碰过」的语义可接受 | 每次调用都写 |
DSN 加 clientFoundRows=true |
整个服务的语义就该是「匹配」 | 静默改变所有调用方 |
第四条是最容易「修一次坏两次」的:它修好了你这个分支,同时把进程里其它所有 RowsAffected() 的含义改掉了。
自己跑一遍
仓库里有一份四条语句的复现脚本,预期输出写在文件头。如果你机器上第一条 UPDATE 返回的是 affected_rows = 1 而不是 0,说明会话已经开了 CLIENT_FOUND_ROWS——这一点值得在排查别的坑之前先确认。
我们验了什么
复现在 MySQL 8.4.13(Ubuntu 26.04 / WSL)上于 2026-11-18 跑过;affected_rows 0/1 与 1062 报错原文均取自该次运行。
安装
把 SKILL.md 拷进 skills/<分类>/mysql-rowsaffected-behavior/,或直接 clone 仓库。