navicat同步出现“duplicate entry for key 'xxx'（非主键）”本质是目标表唯一索引（如email、order_no）存在重复值，需先通过报错key名定位索引，再用show create table验证字段定义，结合select比对源/目标数据，并确保key mapping完整覆盖该唯一索引所有字段。
Navicat 数据同步时出现 Duplicate entry for key 'xxx'（非主键），本质是目标表存在唯一索引（如 email、order_no 或复合唯一键），而同步脚本尝试插入重复值——这不是 Navicat 配置错误，而是源数据与目标数据在该索引字段上已不一致。
怎么确认冲突发生在哪个唯一索引上
报错信息里明确写了 key 名，比如 Duplicate entry 'admin@example.com' for key 'uk_email'，说明冲突来自名为 uk_email 的唯一索引。但别只信这个名，得验证它是否真对应你预期的字段：
- 在目标库执行
SHOW CREATE TABLE users，查找UNIQUE KEY `uk_email` (email)这类定义，确认索引列和类型（VARCHAR(255)vsTEXT会隐式截断） - 用报错值查源表和目标表：
SELECT id, email FROM users WHERE email = 'admin@example.com'，看两边是否都存在、id 是否不同、是否大小写或空格不一致（MySQL 默认不区分大小写，但排序规则为utf8mb4_0900_as_cs时会区分） - 检查源数据本身是否含重复：
SELECT email, COUNT(*) FROM source_users GROUP BY email HAVING COUNT(*) > 1；很多“同步冲突”其实是源文件导出时就重复了
Key Mapping 必须覆盖唯一索引所有字段
Navicat 判断“某行是否已存在”，只依赖你在同步向导 Step 2 的 Key Mapping 中勾选的字段。如果唯一索引是 (user_id, action_type)，但你只勾了 user_id，Navicat 就认为所有 user_id=100 的行都是“新行”，全走 INSERT INTO，必然撞唯一约束。
- 进入
Table Mapping → Key Mapping，手动勾选构成该唯一索引的全部列（不能漏，也不能多） - 复合唯一索引必须全部字段同时勾选，且顺序无需严格一致，但字段名和类型必须能对齐
- 预览时点开某张表 → 底部切到
Difference标签页 → 查看被标为Insert的行：若其唯一索引字段值已在目标存在，说明 Key Mapping 没配对 - 注意 MySQL 的
TEXT字段不能直接做唯一索引，若源表有UNIQUE(email)但email是TEXT类型，实际索引可能无效，导致 Navicat 比对失效
跳过冲突的三种实操路径及副作用
图形界面没有“全局跳过唯一冲突”开关，必须选一种可控方式介入：
-
推荐导出 SQL 后手动替换：在同步向导最后一步勾选
Generate synchronization SQL script，打开生成的.sql文件，全局将INSERT INTO `table_name`替换为INSERT IGNORE INTO `table_name`。它对唯一索引和主键都生效，且静默跳过，但不会告诉你哪几条被跳了 -
用
ON DUPLICATE KEY UPDATE覆盖关键字段：替换为INSERT INTO `table_name` (...) VALUES (...) ON DUPLICATE KEY UPDATE updated_at = VALUES(updated_at), status = VALUES(status)。注意它只触发一次，且仅更新指定字段，但需确保VALUES()写法正确，否则可能把字段设成 NULL -
Navicat 15+ 可启用
Skip duplicate key errors：路径是同步向导 →Options → Error Handling→ 勾选该选项。它只对 INSERT 生效，不影响 UPDATE/DELETE，但旧版本（如 Navicat 12）根本不支持，勾了也无效
最容易被忽略的底层陷阱
很多唯一冲突根本不是同步逻辑问题，而是 MySQL 自身行为被放大：
- 目标表的唯一索引字段定义了
NOT NULL，但源数据该列为空字符串''或 NULL，而 Navicat 导入时未做清洗，导致多条''撞上唯一约束 - MySQL 8.0 开启
STRICT_TRANS_TABLES后，空字符串插入ENUM或SET字段会转成默认值，若默认值相同，就产生重复 - 同步前没关外键检查（
SET FOREIGN_KEY_CHECKS = 0），而唯一索引字段又被外键引用，导致约束校验提前失败，错误信息却显示为 Duplicate entry - Navicat 对
TIMESTAMP字段处理不一致：若源数据该列为 NULL，而目标表定义为TIMESTAMP DEFAULT CURRENT_TIMESTAMP但没设NOT NULL，MySQL 8.0 可能将其存为 NULL，再与其他 NULL 值撞上唯一索引（因 NULL 不参与唯一性校验，但多个 NULL 允许共存——等等，这反而不会报错？不对，重点是：如果唯一索引包含该 TIMESTAMP 字段，而多行都为 NULL，MySQL 认为它们不重复；但若你误以为它该是 CURRENT_TIMESTAMP，实际却是 NULL，那说明源数据质量有问题）
