主键冲突说明实际执行的是数据同步而非纯结构同步;应检查是否误启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 导致冲突。
- 进入
Key Mapping页面,逐个检查每张表——必须勾选真实的主键列(如id),不能靠自动识别 - 复合主键要全部字段勾上,缺一个就退化为全量插入
- 预览时点开某张表 → 底部切到
Difference标签页 → 查看标为Insert的行,如果id值在目标表明明存在,就是 Key Mapping 失效
跳过冲突不能靠勾选项,得改 SQL 或调策略
Navicat 数据同步界面里没有全局“出错继续”开关,所谓“高级设置中勾选发生错误时继续”实际只存在于导入向导,且对主键冲突无效。真正可控的路径只有两条:
- 导出 SQL 后,把所有
INSERT INTO `table_name`批量替换成INSERT IGNORE INTO `table_name`(MySQL)或MERGE(SQL Server) - 不导出,直接在同步向导「Options」→「Conflict Handling」里选
Update existing records,并确保Key Mapping正确——这会让 Navicat 生成INSERT ... ON DUPLICATE KEY UPDATE而非纯INSERT - 别开
Skip duplicate key errors:它等效于INSERT IGNORE,但会静默跳过所有键冲突、截断、空值错误,掩盖真实数据问题
SQL Server 用户注意:跳过选项是摆设
Navicat 15+ 对 SQL Server 的 Continue after error 或 忽略重复记录 选项是灰色禁用状态,不是 Bug,是主动屏蔽——因为 SQL Server 没有 INSERT IGNORE 语义,JDBC 驱动遇到 error 2627 会直接抛异常中断。唯一有效做法是:
- 在导入向导第 2 步「目标表映射」中,把操作从
Insert改为Update - 手动点击主键列名右侧的「匹配」复选框(哪怕看起来已高亮),否则不会生成
WHERE条件 - 确认目标表主键字段类型与源一致,比如 UUID 必须用
uniqueidentifier,不能是int











