如何通过唯一索引和并发控制排查MySQL的Duplicate entry错误？

本文共计1146个文字，预计阅读时间需要5分钟。

MySQL中遇到Duplicate entry 'xxx' for key 'yyy'错误，通常是因为触发了索引名yyy的约束，可能是主键、UNIQUE约束，也可能是唯一索引。不要急于修改代码，先确认这个yyy对应的是哪张表、哪个字段：

• 执行 SHOW CREATE TABLE `table_name`;，搜索 UNIQUE KEY 或 PRIMARY KEY，看 yyy 是否在里面
• 如果 yyy 是形如 uk_user_email 这种自定义名，基本可确定是显式创建的唯一索引；如果是 PRIMARY 或 email（字段名），说明冲突发生在主键或该字段的唯一约束上
• 注意：InnoDB 中，即使没显式加 UNIQUE，但某列被用作外键参照目标时，MySQL 会自动为其加唯一索引（仅限单列外键），这也可能成为报错源头

确认重复值是否真由业务逻辑导致

不是所有重复都来自并发——有些是代码漏校验、缓存未失效、或上游重复推送。