on duplicate key update 是 mysql 中处理主键或唯一索引冲突时“插入或更新”的原子操作。它在 insert 语句后直接定义冲突时的更新逻辑，使用 values(col) 引用待插入值，支持多字段更新、时间戳自动刷新及条件更新（如 greatest），但仅对主键/唯一键冲突生效，且不支持子查询嵌入 values()。
当插入数据时遇到主键或唯一索引冲突，ON DUPLICATE KEY UPDATE 是 MySQL 提供的简洁解决方案。它不是先删后插，也不是手动判断是否存在，而是在一条语句中完成“尝试插入 + 冲突则更新”的逻辑。关键在于明确哪些字段用于判断冲突（即主键或唯一键），哪些字段在冲突时需要更新。
基础语法结构（含多字段更新）
核心写法如下，适用于 INSERT 语句后接冲突处理：
INSERT INTO table_name (col1, col2, col3, col4) VALUES (?, ?, ?, ?) ON DUPLICATE KEY UPDATE col2 = VALUES(col2), col3 = VALUES(col3), col4 = VALUES(col4);
说明：
-
col1 通常是主键或唯一索引列（如
id或email），它的值触发冲突检测； - VALUES(colX) 表示本次 INSERT 中对应位置的待插入值，不是当前行旧值；
- 可同时更新多个非键字段，用逗号分隔；
- 不建议在 UPDATE 子句中更新用于冲突判断的字段（如更新主键值），会导致行为不可预期。
唯一索引冲突的典型场景
当表有多个唯一约束（如 UNIQUE(email) 和 UNIQUE(phone)），只要任一约束被违反，就会触发 UPDATE。例如：
CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, email VARCHAR(255) UNIQUE, phone VARCHAR(20) UNIQUE, name VARCHAR(100), updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP );
此时以下语句可能触发冲突（取决于 email 或 phone 是否已存在）：
INSERT INTO users (email, phone, name)
VALUES ('a@example.com', '13800138000', '张三')
ON DUPLICATE KEY UPDATE
name = VALUES(name),
updated_at = NOW();
安全更新：避免覆盖重要字段
不是所有字段都适合无条件更新。常见做法包括：
- 只更新业务允许“以新代旧”的字段，如
name、status、score； - 对时间戳统一设为
NOW()或CURRENT_TIMESTAMP，而非VALUES(updated_at)； - 若需保留原始创建时间，应单独维护
created_at字段且不在 UPDATE 子句中出现； - 对数值型字段做条件更新（如仅当新值更大时才更新），可用
GREATEST()或IF()函数：
ON DUPLICATE KEY UPDATE score = GREATEST(score, VALUES(score)), attempts = attempts + 1;
注意事项与常见陷阱
使用时需留意以下几点：
- 仅对 主键或唯一索引 冲突生效，普通索引或无索引字段冲突不会触发；
- 如果一行同时违反多个唯一约束（如 email 和 phone 都重复），仍只执行一次 UPDATE；
-
VALUES()函数只能在 ON DUPLICATE KEY UPDATE 中使用，不能用于其他上下文； - 影响行数返回值：插入成功为 1，冲突更新为 2，这是区分操作类型的依据；
- 不支持子查询直接写在
VALUES()中，如需动态值，建议提前计算或改用 REPLACE INTO / MERGE 等替代方案（注意 REPLACE 是删+插，会改变自增 ID）。
