结构同步必须走「工具→结构同步」，不能用「数据同步」或「备份」；多对一场景需两两操作或先合并中间库，误选入口会导致不生成ddl或仅导出快照，且必须校验字符集、sql_mode及忽略注释与外键名以避免虚假差异。

结构同步必须走「工具→结构同步」，不是「数据同步」或「备份」

多对一场景（比如 dev_db.user、uat_db.user → prod_db.user）本质仍是两个库之间的结构比对，Navicat 没有“多源合并”概念。你只能两两操作：先 dev_db → prod_db，再 uat_db → prod_db；或者先把 dev_db 和 uat_db 合并成一个中间库，再同步到 prod_db。误点「数据同步」会生成 INSERT/REPLACE 语句，根本不会动表结构；点「备份」则只导出快照，无法生成差异 DDL。

常见错误现象：ERROR 1060 (42S21): Duplicate column name 'new_field'——这是没做结构比对就直接运行脚本，目标表已存在字段却重复执行 ADD COLUMN。

• 必须从「工具→结构同步」启动，选两个连接（如 dev_db 和 prod_db），不能选「数据同步」入口
• 若需融合多个来源的结构变更，建议先人工合并 DDL 脚本（比如把 dev_db 和 uat_db 的 ALTER TABLE 语句合并去重），再用「结构同步」的「运行自定义脚本」功能执行
• 「结构同步」向导里没有“多源”选项，强行拖拽多个连接进去会静默失败或只识别第一个

比对前必须校验字符集、SQL_MODE 和非业务表

多环境结构不一致最常卡在底层兼容性上。Navicat 不检查这些，但 MySQL 执行时会报错，且错误信息往往不指向真正原因。

典型报错：ERROR 1071 (42000): Specified key was too long; max key length is 3072 bytes——其实是 utf8mb4_0900_as_cs 和 utf8mb4_unicode_ci 混用导致索引长度计算偏差。

• 手动确认源库和目标库的 character_set_database 和 collation_database 完全一致
• 检查双方 SELECT @@sql_mode，尤其确认是否都启用 STRICT_TRANS_TABLES；否则默认值变更会被静默忽略
• 在「结构同步」向导的「对象」页，取消勾选 schema_migrations、tmp_user_log、log_operation 等非业务表——Navicat 默认全量比对，不剔除就会生成无意义甚至危险的 DROP TABLE

生成脚本时「忽略注释」和「忽略外键名称」必须勾选

多团队协作下，字段注释和外键名最容易不一致，但它们不影响实际结构功能。不忽略会导致大量虚假差异，脚本冗长且易出错。

navicatmysql

Navicat For MySQL

下载

例如：dev_db 中外键名为 fk_user_profile_id，uat_db 自动生成为 fk_user_profile_id_2，MySQL 允许同名外键不存在冲突，但 Navicat 会识别为“需 DROP + ADD”，徒增风险。

• 在「结构同步」→「选项」页（不是「高级」页），✅ 勾选「忽略对象定义中的注释」
• ✅ 勾选「忽略外键名称」
• ⚠️ 「使用 IF NOT EXISTS / DROP IF EXISTS」按需选：生产库结构不确定是否存在？选 IF NOT EXISTS；要覆盖已有结构且敢承担风险？选 DROP IF EXISTS——但注意：对表级操作等同于删表重建，别在生产库点「运行」

数据同步要用「工具→数据同步」，WHERE 条件必须填在表映射页 Options 中

结构对齐后，多对一的数据合并才是真难点。Navicat 的「数据同步」支持主键匹配与条件过滤，但 WHERE 不在主界面填，而是在表映射页的「Options」弹窗里——漏填就等于全量覆盖。

常见错误现象：1205 Lock wait timeout exceeded——没加 WHERE 导致同步扫描全表，锁住生产库关键表数分钟。

• 入口必须是「工具→数据同步」，不是「数据传输」；后者无比对逻辑，会删表重建
• 进入「表映射」页后，双击目标表，在弹出的「Options」窗口中填写 WHERE 条件，例如：created_at > '2026-09-01' 或 status = 'active'
• 字段映射须人工核对，尤其注意时间戳字段（updated_at 是否要覆盖）、枚举字段（status 枚举值是否一致），不一致要设为 Ignore
• 主键冲突处理必须显式配置：MySQL 用 ON DUPLICATE KEY UPDATE，PostgreSQL 用 ON CONFLICT DO NOTHING；Navicat 不自动加，不配就报错

多对一合并最易被忽略的是执行顺序：必须先完成所有结构同步（包括索引、约束、默认值），再跑数据同步；结构没对齐就传数据，轻则字段截断，重则主键冲突失败。另外，每次同步前务必用 Navicat 备份功能导出目标库关键表快照——结构同步本身不备份，出事靠它救命。