// MySQL 错误参考
MySQL 错误 1062:键的重复条目
INSERT 或 UPDATE 会将已存在的值插入 PRIMARY KEY 或 UNIQUE 索引。消息会显示该值和键。
- 错误编号
1062- 名称
ER_DUP_ENTRY- SQLSTATE
23000- 类别
- 键和约束
它的意思
如果某行在主键或唯一索引上的值与已有行相同,MySQL 会拒绝该行。消息会显示重复的值和涉及的索引,例如 Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 及更高版本会把表名包括在键中)。
对于多行 INSERT,在 MyISAM 这类非事务表上,重复行之前的各行会保留,但在 InnoDB 上整个语句会回滚。
常见原因
- 重新运行会插入已存在数据的导入或种子脚本。
- 插入一个已经存在的显式 ID,或者一个
AUTO_INCREMENT计数器被设置在当前最大值以下。 - 一个
UPDATE会把唯一列改成另一行已有的值。 - 在具有不区分大小写排序规则的列上创建唯一索引:
[email protected]和[email protected]算作相同的值。
如何修复它
-
查看已持有该值的那一行。
SELECT * FROM users WHERE email = '[email protected]';
-
要更新现有行,请使用
INSERT ... ON DUPLICATE KEY UPDATE。在 MySQL 8.0.19 及更高版本上,可通过行别名引用新值;旧版本则使用VALUES(name),它仍然可用,但已弃用。INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new ON DUPLICATE KEY UPDATE name = new.name; -
要有意跳过重复项,请使用
INSERT IGNORE。它会把错误降级为警告(还有其他一些错误也一样),因此之后请查看SHOW WARNINGS之后。INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada'); -
如果重复项出现在
AUTO_INCREMENT,请对照数据核对计数器。SELECT MAX(id) FROM users; SHOW CREATE TABLE users; -- shows AUTO_INCREMENT=n
安全地复现它
CREATE TEMPORARY TABLE t (id INT PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ERROR 1062 (23000): Duplicate entry '1' for key 't.PRIMARY'
问题
如何找出重复项所在的键?
消息会标明它: for key 'PRIMARY' 是主键,其他则是唯一索引的名称。 SHOW INDEX FROM table_name; 列出索引及其列。
相关错误
1452外键约束失败:无法添加子行1048列不能为空1586键存在重复条目(含键名)23505PostgreSQL:重复键违反唯一约束2627SQL Server:违反 PRIMARY KEY 或 UNIQUE KEYORA-00001Oracle:违反唯一约束SQLITE_CONSTRAINT_UNIQUESQLite:唯一约束失败
更多键和约束错误
1061键名重复1451外键约束失败:无法删除父行1216无法添加或更新子行1217无法删除或更新父行1215无法添加外键约束3780外键列不兼容1822外键约束缺少索引1824无法打开被引用的表
代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 MySQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。