ON DUPLICATE KEY UPDATE 仅在插入时触发唯一约束或主键冲突时生效，必须确保冲突字段上有 UNIQUE 或 PRIMARY KEY 约束，否则不执行更新而直接报错或忽略。
ON DUPLICATE KEY UPDATE 什么情况下才生效
它只在插入时触发唯一约束（UNIQUE）或主键（PRIMARY KEY）冲突时才执行更新，不是“存在任意相同字段就更新”。比如你只给 email 加了 UNIQUE 索引，但插入时重复的是 phone 字段——这个语句完全不触发更新，而是直接报错或忽略（取决于 SQL mode）。
常见错误现象：INSERT INTO user (name, email) VALUES ('Alice', 'a@b.com') ON DUPLICATE KEY UPDATE name = 'Bob' 执行后发现没更新，大概率是 email 字段没建 UNIQUE 索引，或者表里根本没主键/唯一键。
- 必须确保冲突字段上有
UNIQUE或PRIMARY KEY约束 - 不能靠业务层“查一遍再插”来模拟逻辑，那不是
ON DUPLICATE KEY UPDATE的使用场景 - 如果表用的是
MyISAM引擎，注意它对INSERT ... ON DUPLICATE KEY UPDATE的支持有限（尤其多唯一索引时行为不一致）
UPDATE 子句里怎么安全引用新值和旧值
ON DUPLICATE KEY UPDATE 的 SET 部分不能直接用 VALUES() 函数以外的方式拿到“本次想插入的值”，但可以用 VALUES(col_name) 显式引用——这是最不容易出错的方式。
比如你想让 updated_at 总是设为当前时间，同时把 name 更新为插入值：
INSERT INTO user (id, name, email, updated_at) VALUES (1, 'Tom', 't@b.com', NOW()) ON DUPLICATE KEY UPDATE name = VALUES(name), updated_at = NOW();
常见陷阱：name = name 这种写法看似无害，实际会让该字段保持原值，且容易被误读成“赋新值”；更危险的是 score = score + 1 这类自增逻辑——若并发插入同一行，可能漏更新（因为两个事务都读到旧值再加 1）。
- 一律优先用
VALUES(col)表达“本次插入的值” - 避免在
UPDATE子句里做非幂等计算（如counter = counter + 1），高并发下结果不可控 -
VALUES()只能在ON DUPLICATE KEY UPDATE中用，不能在普通UPDATE里出现
和 REPLACE INTO、INSERT IGNORE 的关键区别在哪
REPLACE INTO 是“删+插”，会触发 DELETE 和 INSERT 两轮操作：自增 ID 会变、外键级联动作会被触发、触发器会跑两次；INSERT IGNORE 是“插失败就静默跳过”，不更新也不报错；而 ON DUPLICATE KEY UPDATE 是真正的“原子更新”，不改变 ID，不触发删除相关逻辑。
性能影响明显：当表有大量二级索引或外键时，REPLACE INTO 的开销远高于 ON DUPLICATE KEY UPDATE；而 INSERT IGNORE 在你需要“仅插入不更新”时更轻量。
- 要保留原
id、避免触发DELETE相关逻辑 → 必选ON DUPLICATE KEY UPDATE - 只想插入，重复了就不管 → 用
INSERT IGNORE更高效 - 需要自动重置关联数据（比如清空子表再重建）→ 才考虑
REPLACE INTO，但得确认业务能接受 ID 变动
MySQL 8.0+ 下 VALUES() 函数的兼容性注意点
MySQL 8.0.19 起，VALUES(col) 在 ON DUPLICATE KEY UPDATE 中的行为更严格：它只代表“当前 INSERT 语句中对应位置的值”，不再兼容老版本中某些模糊匹配逻辑。如果你用的是预编译语句（PREPARE + EXECUTE），参数顺序和 VALUES() 的列名必须严格对应。
错误示例：INSERT INTO t(a,b) VALUES (?, ?) ON DUPLICATE KEY UPDATE a = VALUES(b) —— 这会报错，因为 VALUES(b) 指向第二个占位符，但字段 b 并不在 INSERT 的列列表里（只写了 a,b，没问题），真正问题是列名和值位置不匹配。
- 列名必须真实存在于
INSERT的列列表中，且大小写敏感（取决于lower_case_table_names设置） - 在存储过程中动态拼 SQL 时，别用变量替换列名，否则
VALUES()解析会失败 - 如果升级到 8.0.19+ 后发现更新失效，先检查
VALUES()里的列名是否拼错或大小写不对
VALUES(col) 能跨语句取值——它只认当前这一条 INSERT 里的值。
