phpMyAdmin导入“Duplicate entry”报错因默认用INSERT且不支持UI替换，需手动将SQL文件中的INSERT INTO改为REPLACE INTO或INSERT...ON DUPLICATE KEY UPDATE；导出时勾选“REPLACE statements”可提前生成替换语句，但REPLACE会导致自增ID跳变且可能触发级联删除，慎用于有外键或依赖连续ID的场景。
导入时遇到“Duplicate entry”报错，说明没启用替换逻辑
phpmyadmin 默认导入行为是 insert，遇到主键或唯一键冲突直接中断。它本身不提供勾选“自动替换”的 ui 选项，所谓“用 replace 或 on duplicate key update”必须靠修改 sql 文件内容或调整导出设置来实现。
常见错误现象：#1062 - Duplicate entry '1' for key 'PRIMARY'；导入中途停止，只写入前几条；明明勾了“忽略重复”，但实际没生效（那是针对 INSERT IGNORE，不是替换）。
- 如果你手头已有 SQL 文件，打开后把每行
INSERT INTO批量替换成REPLACE INTO（注意：REPLACE是 MySQL 特有语法，会先删后插，可能触发级联删除或重置自增 ID） - 更稳妥的方式是改用
INSERT ... ON DUPLICATE KEY UPDATE，但需手动补全更新字段，例如：INSERT INTO users (id, name) VALUES (1,'Alice') ON DUPLICATE KEY UPDATE name=VALUES(name); - phpMyAdmin 导出时可提前选“
REPLACEstatements” —— 这个选项在「自定义导出」→「格式特定选项」里，勾上它，导出的文件就自带REPLACE INTO，后续导入自然覆盖
用 phpMyAdmin 导入大文件时，REPLACE 可能导致自增 ID 跳变
REPLACE INTO 底层是先 DELETE 再 INSERT，哪怕只是更新一行，也会让该表的 AUTO_INCREMENT 值+1。对依赖连续 ID 的业务（比如某些分页逻辑或外部引用），这很危险。
使用场景：你正在同步测试库和生产库，主键相同但其他字段要更新，且不关心 ID 是否连续。
- 确认表没有外键约束指向该主键，否则
REPLACE可能失败或级联删数据 - 如果只是想更新非主键字段，优先用
INSERT ... ON DUPLICATE KEY UPDATE，它不改变自增计数器 - 导入前执行
SET sql_mode='STRICT_TRANS_TABLES';可避免因字段长度超限等隐性问题导致部分REPLACE失败却无提示
导入失败后看不到完整错误 SQL，调试得开 phpMyAdmin 日志或换命令行
phpMyAdmin 导入界面只显示第一条错误，比如 #1062，但不会告诉你具体哪一行 SQL 出问题、原值是什么。尤其当文件里混用 REPLACE 和普通 INSERT 时，定位成本很高。
立即学习“PHP免费学习笔记（深入）”；
- 临时改小导入文件：用文本编辑器切出前 10 行，手动加
SELECT SLEEP(0.1);分隔，逐段粘贴到 SQL 标签页执行，看哪句报错 - 把 SQL 文件丢进终端用
mysql -u user -p database ，错误信息更全，还能看到出错行号 - 检查原始数据里是否有不可见字符（如 BOM、零宽空格），它们会让
REPLACE INTO解析失败，表现为语法错误而非主键冲突
ON DUPLICATE KEY UPDATE 的字段别名陷阱
写 ON DUPLICATE KEY UPDATE 时，右边不能直接写变量名，必须用 VALUES(col_name) 或显式值。新手常写成 UPDATE name='xxx'，结果所有冲突行都更新成同一个固定值。
参数差异：VALUES(name) 指“本次 INSERT 尝试插入的 name 值”，不是当前行旧值；如果想保留旧值，得写 name=name，但这样等于没更新。
- 安全写法示例：
INSERT INTO logs (url, count) VALUES ('/api', 1) ON DUPLICATE KEY UPDATE count = count + VALUES(count); - 如果字段多，又不想逐个写
VALUES()，导出时选「INSERT IGNORE」+「启用延迟键写入」更省事，至少不会报错中断 -
REPLACE不支持ON DUPLICATE子句，两者语法互斥，别混用
事情说清了就结束。真正麻烦的从来不是加个 REPLACE，而是确认那条被“替换”的数据，到底该删、该更新、还是该跳过——这得看业务逻辑，phpMyAdmin 不帮你判断。
