不能靠“忽略”掩盖逻辑问题,需区分真重复与策略错配;有效方案为INSERT IGNORE跳过冲突,或ON DUPLICATE KEY UPDATE主动更新指定字段。
MySQL 导入遇到 1062 Duplicate entry 怎么办
直接说结论:不能靠“忽略”来掩盖数据逻辑问题,得先分清是「真重复」还是「导入策略错配」。常见做法只有两个有效方向——用 insert ignore 跳过冲突行,或用 replace into / on duplicate key update 主动覆盖。但选哪个,取决于你到底想保留哪条数据。
INSERT IGNORE 什么时候能用、为什么常踩坑
它会让 MySQL 遇到主键/唯一键冲突时静默跳过整行,不报错也不插入。表面省事,实则容易埋雷:
- 所有约束冲突(不只是主键)都会被忽略,比如唯一索引、外键失败,你完全感知不到
- 自增 ID 会被消耗但没插入成功,后续 ID 可能断层或偏大
- 如果源数据里有本该更新的字段(比如状态、时间戳),
INSERT IGNORE完全不碰它,旧值就一直留着 - 适合场景:纯补录、确认无业务字段需更新,且只关心“存在性”,比如日志去重、用户注册记录归档
示例:INSERT IGNORE INTO users (id, name, created_at) VALUES (123, 'Alice', NOW());
ON DUPLICATE KEY UPDATE 比 REPLACE INTO 更可控
REPLACE INTO 看似简单,其实是“删+插”两步:先按主键删旧行,再插入新行。这会触发 DELETE 和 INSERT 的所有副作用(如外键级联、触发器、自增 ID 重置),还可能丢失未显式指定的字段值。
ON DUPLICATE KEY UPDATE 只更新指定列,不动其他字段,语义清晰、副作用可控:
- 必须显式列出要更新的字段,比如
updated_at = NOW(), status = VALUES(status) -
VALUES(col)表示本次 INSERT 尝试写入的值,不是当前行原值 - 不会触发 DELETE 相关逻辑,外键和触发器行为更可预测
- 注意:UPDATE 部分不校验其他唯一约束,如果更新后导致新冲突,会直接报错
示例:INSERT INTO users (id, name, status) VALUES (123, 'Alice', 'active') ON DUPLICATE KEY UPDATE status = VALUES(status), updated_at = NOW();
批量导入时怎么避免 1062 错误中断整个过程
mysqldump 或 LOAD DATA INFILE 默认遇到错误就停。想继续执行,得提前控制行为:
- 用
mysql --force命令行参数,让客户端跳过单条错误继续(但无法区分错误类型,慎用) - 对
LOAD DATA INFILE,加IGNORE关键字(LOAD DATA INFILE 'x.csv' IGNORE INTO TABLE t;),效果类似INSERT IGNORE - 真正稳妥的做法:先导出冲突主键,预处理源数据,或拆成小批次 + 事务 + 错误捕获逻辑(比如用 Python 的
pymysql捕获1062后单独处理) - 别依赖
SET FOREIGN_KEY_CHECKS=0来绕过约束——它不解决主键冲突,还可能破坏数据一致性
最容易被忽略的一点:1062 错误里的 Duplicate entry 'xxx' for key 'PRIMARY',那个 'xxx' 是实际冲突的值,不是语句里的变量名。查日志时盯住它,才能快速定位是数据本身重复,还是导入脚本把同一行写了两次。










