如何处理Navicat自动同步中的主键冲突

主键冲突说明实际执行的是数据同步而非纯结构同步；应检查是否误启Synchronize data选项、预览SQL是否含INSERT语句，并确认Key Mapping准确匹配主键（如id），复合主键需全部字段勾选，否则会误判Update为Insert导致冲突。

主键冲突说明你根本没在做纯结构同步

看到 Duplicate entry '123' for key 'PRIMARY' 就能断定：Navicat 正在执行数据写入，不是结构变更。结构同步（Structure Synchronization）只生成 ALTER TABLE、CREATE INDEX 等 DDL，绝不会出现 INSERT。如果你勾了 Synchronize data 选项，或预览 SQL 里全是 INSERT INTO，那这就是数据同步任务，不是模型同步。

Key Mapping 错了才会把 Update 判成 Insert

Navicat 判断“某行是否已存在”，完全依赖你在 Step 2 的 Key Mapping 设置。它默认只用主键比对，但一旦你没手动确认、或表无主键、或映射字段类型不一致（比如源是 BIGINT、目标是 INT），就会误判已有记录为新记录，强行 INSERT 导致冲突。

1. 进入 Key Mapping 页面，逐个检查每张表——必须勾选真实的主键列（如 id），不能靠自动识别
2. 复合主键要全部字段勾上，缺一个就退化为全量插入
3. 预览时点开某张表 → 底部切到 Difference 标签页 → 查看标为 Insert 的行，如果 id 值在目标表明明存在，就是 Key Mapping 失效

跳过冲突不能靠勾选项，得改 SQL 或调策略

Navicat 数据同步界面里没有全局“出错继续”开关，所谓“高级设置中勾选发生错误时继续”实际只存在于导入向导，且对主键冲突无效。真正可控的路径只有两条：

1. 导出 SQL 后，把所有 INSERT INTO `table_name` 批量替换成 INSERT IGNORE INTO `table_name`（MySQL）或 MERGE（SQL Server）
2. 不导出，直接在同步向导「Options」→「Conflict Handling」里选 Update existing records，并确保 Key Mapping 正确——这会让 Navicat 生成 INSERT ... ON DUPLICATE KEY UPDATE 而非纯 INSERT
3. 别开 Skip duplicate key errors：它等效于 INSERT IGNORE，但会静默跳过所有键冲突、截断、空值错误，掩盖真实数据问题

SQL Server 用户注意：跳过选项是摆设

Navicat 15+ 对 SQL Server 的 Continue after error 或 忽略重复记录 选项是灰色禁用状态，不是 Bug，是主动屏蔽——因为 SQL Server 没有 INSERT IGNORE 语义，JDBC 驱动遇到 error 2627 会直接抛异常中断。唯一有效做法是：

1. 在导入向导第 2 步「目标表映射」中，把操作从 Insert 改为 Update
2. 手动点击主键列名右侧的「匹配」复选框（哪怕看起来已高亮），否则不会生成 WHERE 条件
3. 确认目标表主键字段类型与源一致，比如 UUID 必须用 uniqueidentifier，不能是 int

关键点始终落在：冲突不是意外，是数据状态不一致的显式信号；而 Navicat 本身不会猜测你想要什么，它只忠实地按你配的 Key 和策略执行。配错 Key Mapping，再怎么调“跳过”都只是掩耳盗铃。