mysql主键冲突错误如何解决_mysql约束异常处理-mysql教程-PHP中文网

MySQL主键冲突报错1062需显式处理：用INSERT IGNORE忽略、ON DUPLICATE KEY UPDATE更新或REPLACE INTO替换；后者会改变自增ID且慎用；ON DUPLICATE KEY UPDATE需注意NULL和表达式逻辑，批量插入无法直接定位冲突行。

mysql主键冲突错误如何解决_mysql约束异常处理

INSERT 时主键冲突报错 `1062 Duplicate entry` 怎么办

MySQL 遇到主键或唯一索引重复时，直接抛出 ERROR 1062 (23000): Duplicate entry 'xxx' for key 'PRIMARY'，默认中断执行。这不是语法错误，而是约束校验失败，必须明确告诉 MySQL「冲突时想怎么处理」。

常见做法有三种，选哪个取决于业务语义：

忽略冲突：用 INSERT IGNORE，冲突时静默跳过整行，不报错也不插入
存在则更新：用 INSERT ... ON DUPLICATE KEY UPDATE，冲突时执行指定字段更新（如更新 updated_at 或累加计数）
强制替换：用 REPLACE INTO，本质是先 DELETE 再 INSERT，会触发自增 ID 变化和外键级联动作，慎用

注意：INSERT IGNORE 和 ON DUPLICATE KEY UPDATE 只对主键（PRIMARY KEY）和唯一索引（UNIQUE KEY）生效，普通索引无效。

`ON DUPLICATE KEY UPDATE` 的字段更新逻辑容易踩坑

这个语法看似简单，但更新行为和 NULL、默认值、表达式有关，不是无脑覆盖：

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

如果更新子句中写 col = col + 1，即使 col 原值为 NULL，结果也是 NULL（因为 NULL + 1 = NULL），需用 IFNULL(col, 0) + 1
不能在 UPDATE 子句里引用刚插入的值（比如 INSERT ... VALUES (1, 'a') ON DUPLICATE KEY UPDATE name = VALUES(name) 是合法的，但 VALUES(id) 在更新侧不可用）
如果表有多个唯一键，只要任意一个命中就会触发更新；但更新只作用于 SET 后列出的字段，其余字段不变

INSERT INTO user_stats (user_id, login_count, last_login) 
VALUES (123, 1, NOW()) 
ON DUPLICATE KEY UPDATE 
  login_count = IFNULL(login_count, 0) + 1, 
  last_login = NOW();

批量插入时部分失败，如何知道哪几行冲突了

MySQL 默认不返回冲突详情，INSERT ... ON DUPLICATE KEY UPDATE 执行后，mysql_affected_rows()（C API）、cursor.rowcount（Python）或 mysqli_affected_rows() 返回的是「实际变更行数」：新插入算 1 行，更新算 2 行，忽略算 0 行。但不会告诉你哪条数据被忽略或更新。