MySQL报1062:重复的是哪一个唯一键
出现ERROR 1062: Duplicate entry,表示某次写入碰到了主键或唯一索引约束。它不等于数据库损坏,也不能一律通过更换id解决:报错中的key可能是手机号、业务编号,或多个字段共同组成的唯一键。
本文针对MySQL 8.0、8.4的应用写入与导入排查。先保存失败语句的上下文、索引名、该次输入和事务状态,暂停同一失败批次的无限重试。下面只读SQL在已获授权的数据库连接里执行,不直接修改正式数据。
把报错中的key对应到索引
先核对实例与表结构。app_db、jobs是示例库表名,必须换成实际对象:
SELECT VERSION(), DATABASE();
SHOW CREATE TABLE `app_db`.`jobs`;
SHOW INDEX FROM `jobs` FROM `app_db`;
在SHOW INDEX里按Key_name找到报错索引。Non_unique为0表示不能重复;PRIMARY表示主键。复合索引会有多行,按Seq_in_index查看字段顺序,不能只检查第一列。Sub_part提示索引只使用列的前缀,Expression则可能表明索引基于表达式。
例如实际约束是UNIQUE(tenant_id, external_no),冲突要按这两个字段一起查。确认它确实是普通完整列索引后,再使用下面的思路;42和JOB-001同样要换成出错输入:
SELECT id, tenant_id, external_no,
HEX(external_no) AS external_no_hex
FROM `app_db`.`jobs`
WHERE tenant_id=42 AND external_no='JOB-001'
LIMIT 5;
查到记录后,核对它属于谁、是否已完成,以及本次输入是否真的对应同一业务。查不到也不能马上重试:可能查询了副本、其他实例,或者同一批输入内部就有两行互相冲突。前缀或表达式索引还需要按实际比较规则另写查询,不能套用上述完整列条件。
为什么肉眼不同也会冲突
字符唯一键按列的排序规则比较,不一定按字节逐一比较。某些规则忽略大小写或重音,尾部空格是否有区别也取决于规则。两个字符串看起来不同,仍可能被判定相等。
SHOW FULL COLUMNS FROM `jobs` FROM `app_db`;
这里的Collation才是字符列的排序规则;SHOW INDEX中的Collation通常是A或D,表示索引升降序,不能混为一谈。结合HEX结果核对原字节,不要为了通过一次写入就把正式列改成另一种规则:搜索、排序和既有唯一性判断都会受影响。
若冲突的是PRIMARY,再确认应用有没有显式提交原本应自动生成的主键,或者迁移脚本重复使用了旧编号。不要用“查最大值再加一”代替可靠的编号生成;并发请求可能同时拿到同一个值,也不要随意重置自增起点。
分清重复请求、编号冲突和重复导入
同一业务重复提交:先比对业务主体、关键参数和已存在记录的处理结果。只有确认是同一操作,才能按应用的幂等设计返回既有结果;同一编号对应不同内容时,应报告冲突,不能直接当作成功。仅在插入前SELECT一次,也无法挡住两个并发请求同时通过检查。
不同业务错误复用编号:修复产生冲突的输入或编号分配逻辑,保留已有记录及引用关系。若唯一范围设计错了,应先评估业务规则、历史数据和相关代码,再安排结构变更;删除唯一索引会把保护问题变成数据问题。
恢复或批量导入重复:核对目标是否为空、上一次是否已写入一部分、原文件是否重复包含相同记录。在新建的隔离测试环境重新演练,不能清空正式表“重来”。基础流程见MySQL备份与隔离恢复。
对InnoDB,违反唯一约束的普通写入语句通常会回滚该语句;这不代表同一事务之前的操作或先前导入语句都已回滚。非事务表还可能留下部分结果。由程序按明确的事务边界处理失败,不根据一条报错推断整批数据状态。
保留约束,验证正确的冲突处理
INSERT IGNORE可能跳过冲突行,让任务继续但缺少应有数据;REPLACE具有删除旧行再插入的语义,未提供的列还可能回到默认值。ON DUPLICATE KEY UPDATE会修改已有行,在多个唯一索引同时存在时更不能当成通用修复。是否采用这些语句,要先定义业务行为。
在隔离环境分别测试首次提交、同内容重复提交、同编号不同内容和并发提交。验收不仅看1062是否消失,还要确认最终记录数量、处理状态、关联数据及重复请求返回值符合设计。正式修复后观察错误是否仍持续增长,保留此前冲突记录便于核对。