结构同步前必须确认三件事:数据库版本兼容性、数据一致性风险及用户权限完整性,否则易生成错漏SQL。
结构同步前必须确认三件事
直接点“开始同步”大概率生成错漏 sql。先检查这三点:
两个连接必须使用 mysql 5.7+ 或 postgresql 10+ 等 navicat 明确支持的版本;mysql 8.0 与 mysql 5.6 混用时,json 字段、隐藏索引等特性会静默丢失
目标库(通常是旧库)需提前备份,navicat 同步过程不校验数据一致性,只管结构;若误选反向同步方向,drop table 会直接执行
连接用户权限必须包含 select(源库)、select + show view + lock tables(目标库),缺 lock tables 会导致比对卡在“正在获取表元信息”
选错源和目标,SQL 方向就全反了
Navicat 的结构同步不是双向 diff 工具,它本质是「生成从源到目标的 DDL 变更脚本」。
想看「开发库有哪些改动还没上生产」→ 开发库是源,生产库是目标
结构同步对话框中,左侧数据库是你「当前要更新」的那个(比如旧库),右侧是「希望对齐」的那个(比如新库)
比对完成后,看顶部状态栏是否显示“将对 [左侧库名] 应用以下更改”——这是唯一能快速验证方向是否正确的提示
如果发现方向错了,别点“部署”或“运行”,直接关掉重开,重新拖拽顺序
生成 SQL 时绕过默认陷阱
点击“下一步”后进入 SQL 预览页,这里最容易出问题:
默认生成的 SQL 包含 SET FOREIGN_KEY_CHECKS=0,但若目标库存在外键级联约束,该语句可能让后续 ALTER TABLE 失效;建议手动删掉这两行,改用 SET FOREIGN_KEY_CHECKS=1 结尾ENUM 字段新增值的处理是重建整个字段(MODIFY COLUMN),而非安全的 ALTER TABLE CHANGE COLUMN ENUM();若线上表数据量大,务必把这类语句替换成 ALTER TABLE t1 MODIFY COLUMN status ENUM('a','b','c','d') NOT NULL 形式
预览窗口右上角有导出 SQL 文件按钮,但导出内容不含分号结尾,执行时报错 ERROR 1064;必须打开文件,全局替换 \n 为 ;\n,或在 Navicat 执行前勾选“每条语句后添加分号”(该选项藏在“高级”标签页里)
忽略无关差异才能聚焦真实变更
Navicat 默认比对全部对象,但实际只需关注表结构变更:
在“对象选择”页,取消勾选 Stored Procedures、Functions、Events——这些对象的定义差异常因注释、换行、空格触发误报,且业务逻辑变更不该靠结构同步驱动
点击选项按钮,勾选“忽略列顺序”和“忽略默认值中的引号”:MySQL 对 DEFAULT '2023-01-01' 和 DEFAULT "2023-01-01" 视为不同,但语义一致
常见现象:两个表字段名、类型、长度完全一致,但 Navicat 仍标为黄色“修改”,点开 DDL 比较标签却发现只有 COLLATE utf8mb4_0900_as_cs 和 COLLATE utf8mb4_unicode_ci 的区别。这类差异不会影响业务逻辑,但会触发 ALTER TABLE CONVERT TO CHARACTER SET,可能引发锁表或隐式转换风险。可在对比结果列表中右键该条目 → 选择“忽略此项”
真正容易被忽略的是:Navicat 不会告诉你哪些差异是“语义等价但语法不同”,比如 TINYINT(1) 和 BOOLEAN;也不会自动跳过 COMMENT 或 ENGINE 的微小变动——这些都得人工逐条核对 DDL 比较标签里的原始输出。











