MySQL #1062 Duplicate entry 主键冲突解决方法

错误现象与原因

在进行 WordPress、Discuz! 或其他应用的数据迁移时，如果直接运行 SQL 导入脚本，可能会看到如下报错：

#1062 – Duplicate entry '1′ for key ‘PRIMARY'
Error: Duplicate entry '2678' for key 1
Errno.: 1062

其背后的逻辑非常直观：SQL 语句试图向表中插入一条记录，而该记录的主键值（如 `id` 或 `pid`）在目标表中已经存在。由于主键列被定义为 PRIMARY KEY，它必须保持唯一性，因此数据库拒绝写入并抛出异常。这通常发生在增量恢复或多次尝试导入未完全清理的中间状态时。

标准解决方法

要解决这个问题，核心目标是“腾出空间”，即清除掉阻碍新数据进入的旧记录，但保留表的结构定义。请按以下步骤操作：

第1步：定位涉及的表名

查看报错信息，确认具体是哪个表引发了冲突。在报错日志中，通常会包含类似 INSERT INTO [Table]posts... 的语句，这里的 posts 就是目标表名。如果是 Discuz! 论坛等复杂环境，请留意前缀（如 cdb_posts）。

第2步：清空目标表数据

登录 phpMyAdmin 或通过命令行连接 MySQL 客户端。选中对应的数据库，找到冲突的那个表。执行以下 SQL 命令来清空所有现有记录（注意：TRUNCATE 会重置自增计数器）：

TRUNCATE TABLE cdb_posts;

这里使用 TRUNCATE 而不是 DELETE，因为前者效率更高且能彻底重置 Auto_Increment 的值，防止后续导入时 ID 分配依然出现冲突。

第3步：重新导入数据

清空完成后，再次执行之前失败的 SQL 导入文件。由于表内现在是空的，且自增起点已被重置，数据应当能够顺利写入。

关于数据表文件损坏的情况

部分用户在搜索解决方案时会遇到一种特殊情况：即使删除了表，导入依然失败，或者备份文件本身存在问题。这种情况可能源于 MyISAM 存储引擎的索引文件（.MYI）受损。虽然现代部署多采用 InnoDB 引擎，但在一些老旧系统或特定配置下仍可能遇到。

如果遇到此类底层文件损坏，可以使用命令行工具进行修复：

myisamchk /path/to/database/cdb_posts.MYI -r

注意：执行修复前务必备份整个数据库目录，以防误操作导致不可逆的数据丢失。此外，如果在导入后网站发帖等功能仍然报错，可能是由于应用缓存未更新或关联逻辑存在瑕疵，建议检查应用层面的错误日志。

总结

#1062 错误本质上是数据完整性约束被违反的提示。解决它的关键在于理解“主键唯一”的原则，并在导入前主动清理可能产生重叠的存量数据。通过 TRUNCATE 快速复位表的自增状态，通常是解决此类迁移问题的最直接手段。以上就是解决MySQL导入时遇到#1062主键冲突详细内容的介绍，更多关于MySQL数据库维护的资料请关注本站其它相关文章！