MySQL用INSERT...ON DUPLICATE KEY UPDATE原子处理冲突,依赖唯一索引,误写VALUES(col)或缺失索引将导致失效;SQLite用ON CONFLICT DO UPDATE或INSERT OR IGNORE;PostgreSQL需显式声明冲突目标并用EXCLUDED伪表。

MySQL 用 INSERT ... ON DUPLICATE KEY UPDATE 原子处理冲突
这是最常用也最安全的方式,语义明确:尝试插入,若主键或任意唯一索引(PRIMARY KEY 或 UNIQUE KEY)冲突,则更新指定字段。它不删行、不改自增 ID、不触发 DELETE 触发器。
常见错误:
- 没建对应唯一索引——
ON DUPLICATE KEY UPDATE完全不生效,照样报ERROR 1062 - 误写
VALUES(col)为col,导致更新成旧值而非本次插入值 - 在有多个唯一索引的表里,只靠一个字段判断是否更新,却没意识到另一索引冲突也会触发该逻辑
示例:INSERT INTO users (id, email, name) VALUES (1, 'a@b.com', 'Alice') ON DUPLICATE KEY UPDATE name = VALUES(name), email = VALUES(email);
SQLite 用 INSERT OR IGNORE 或 ON CONFLICT DO UPDATE
INSERT OR IGNORE 适合“只新增、不覆盖”的场景,比如日志补录或配置初始化。它静默跳过整条语句,不报错也不更新,但也不会告诉你跳了什么。
ON CONFLICT (col) DO UPDATE 是更精细的控制方式,从 SQLite 3.24+ 开始支持,行为接近 PostgreSQL。注意必须显式写出冲突目标列(如 ON CONFLICT(email)),且不能引用未声明在 ON CONFLICT 中的唯一约束列,否则可能二次冲突。
示例:INSERT INTO stats (day, hits) VALUES ('2026-09-30', 1) ON CONFLICT(day) DO UPDATE SET hits = hits + 1;
PostgreSQL 用 INSERT ... ON CONFLICT DO UPDATE 显式声明冲突目标
PostgreSQL 要求你明确写出冲突依据,比如 ON CONFLICT (id) 或 ON CONFLICT ON CONSTRAINT users_pkey。它不接受模糊匹配,避免误触发。
关键点:
-
EXCLUDED是伪表,代表本次 INSERT 尝试插入的那行数据,不是已存在的行 - 更新子句中不能引用未在
ON CONFLICT中声明的唯一约束列,否则可能违反约束 - 若想跳过更新(比如新值为空时不覆盖),得用
CASE或COALESCE控制逻辑
示例:INSERT INTO users (id, name) VALUES (1, 'Bob') ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name WHERE EXCLUDED.name IS NOT NULL;
别踩这些坑:没索引、混用语法、忽略返回值
所有去重机制都依赖底层唯一约束。没建 UNIQUE KEY 或 PRIMARY KEY,IGNORE、ON DUPLICATE KEY UPDATE、ON CONFLICT 全部失效——先跑 SHOW CREATE TABLE your_table; 确认索引存在且覆盖你要判重的字段。
另外:INSERT IGNORE 和 ON DUPLICATE KEY UPDATE 互斥,连写直接语法报错;REPLACE INTO 是先 DELETE 再 INSERT,会破坏外键引用、触发双重触发器、导致自增 ID 跳变,除非确认无外键且能接受副作用,否则别用。
最后,mysql_affected_rows() 返回值要真看:1 表示插入,2 表示更新(即冲突后执行了 UPDATE),0 表示被 IGNORE 或无变化——别只看是否为 0 就认为成功。

















