ON DUPLICATE KEY UPDATE未生效的最常见原因是表缺少主键或唯一索引，因该机制仅在违反PRIMARY KEY或UNIQUE约束时触发，无约束则不执行UPDATE且可能报错；需确保冲突字段已建对应唯一性约束。
直接用 ON DUPLICATE KEY UPDATE 就行，但前提是表里得有主键或唯一索引，否则它压根不触发。
为什么 ON DUPLICATE KEY UPDATE 没生效？
最常见原因是：目标字段没建 PRIMARY KEY 或 UNIQUE 约束。MySQL 只在违反这两类约束时才执行 UPDATE 部分，其他重复（比如普通字段值一样）完全不管。
- 检查语句是否真的触犯了唯一性约束，例如执行
INSERT INTO users (username) VALUES ('alice') ON DUPLICATE KEY UPDATE status = 'active'，但username字段没设UNIQUE，那就会直接报错Duplicate entry 'alice' for key 'xxx'，UPDATE 根本不跑 - 多个唯一索引存在时（比如同时有
id主键和email唯一索引），只要任一索引冲突就触发，但 UPDATE 只更新你显式写出的字段，不会动其他列 - 如果冲突由
email引起，但你在ON DUPLICATE KEY UPDATE里只写了name = VALUES(name)，那email字段本身不会被修改——它只是判断依据，不是更新目标
VALUES() 函数怎么安全引用插入值？
用 VALUES(column_name) 能避免手写重复值，尤其批量插入时更可靠；但它不是万能的，注意两个边界：
MySQL8 CRM Schema Design Expert
下载
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
-
VALUES()只在当前INSERT ... VALUES子句的上下文中有效，不能跨行、不能在子查询里用 - MySQL 8.0.20+ 已标记
VALUES()为“deprecated”，虽暂未移除，但建议在新项目中改用显式变量或应用层拼接，比如把score = VALUES(score)换成score = ?（预编译参数） - 累加场景常用写法：
score = score + VALUES(score)，这比先查再更新少一次 round-trip，但要注意并发下可能丢失更新（无锁）
批量插入时，ON DUPLICATE KEY UPDATE 的行为细节
一次插多行，每行独立判断冲突，各自决定是 insert 还是 update，返回的受影响行数是总和（1=插入，2=更新）：
INSERT INTO users (id, name, version) VALUES (1, 'a', 1), (2, 'b', 1), (1, 'a-new', 2) ON DUPLICATE KEY UPDATE version = VALUES(version);
- 第 1 行和第 3 行 id=1 冲突，第 3 行触发 update，version 变成 2
- 第 2 行正常插入
- 最终返回受影响行数为 3（1 插入 + 2 更新）
- 注意：如果表有多个唯一索引（如
id和code），某行同时违反两者，UPDATE 仍只执行一次，且 WHERE 条件等价于WHERE id = ? OR code = ? LIMIT 1，只更新匹配到的第一行
真正容易被忽略的是：当表含 AUTO_INCREMENT 字段时，哪怕最终走的是 update 分支，自增计数器也会+1——这会导致后续插入出现 ID 间隙，监控告警时别误判为异常丢数据。
