← 全部技能

MySQL 的 RowsAffected 不是「匹配行数」

UPDATE 返回的是真正改动的行数,不是匹配的行数。写成 if affected == 0 { INSERT } 就是一颗 1062 炸弹,这里给出四种改法。

REPO gengyue-ai/mysql-rowsaffected-behaviorLICENSE MIT我们验了什么 已复现 · 2026-11-18
它解决什么

重复写入同一个值时 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 仓库。

仓库 ↗

出处