// MySQL 错误参考

MySQL 错误 1062:键的重复条目

INSERT 或 UPDATE 会将已存在的值插入 PRIMARY KEY 或 UNIQUE 索引。消息会显示该值和键。

错误编号
1062
名称
ER_DUP_ENTRY
SQLSTATE
23000
类别
键和约束
错误信息
Duplicate entry '%s' for key %d

它的意思

如果某行在主键或唯一索引上的值与已有行相同,MySQL 会拒绝该行。消息会显示重复的值和涉及的索引,例如 Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 及更高版本会把表名包括在键中)。

对于多行 INSERT,在 MyISAM 这类非事务表上,重复行之前的各行会保留,但在 InnoDB 上整个语句会回滚。

常见原因

  • 重新运行会插入已存在数据的导入或种子脚本。
  • 插入一个已经存在的显式 ID,或者一个 AUTO_INCREMENT 计数器被设置在当前最大值以下。
  • 一个 UPDATE 会把唯一列改成另一行已有的值。
  • 在具有不区分大小写排序规则的列上创建唯一索引: [email protected] 和 [email protected] 算作相同的值。

如何修复它

  1. 查看已持有该值的那一行。

    SELECT * FROM users WHERE email = '[email protected]';
  2. 要更新现有行,请使用 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;
  3. 要有意跳过重复项,请使用 INSERT IGNORE。它会把错误降级为警告(还有其他一些错误也一样),因此之后请查看 SHOW WARNINGS 之后。

    INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
  4. 如果重复项出现在 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; 列出索引及其列。

相关错误

更多键和约束错误

代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 MySQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。