Navicat 17 不自动解决表结构冲突,同步依赖人工约定而非工具智能合并;其结构同步仅比对当前快照、无历史追踪、无乐观锁,覆盖逻辑取决于源/目标设定,易致本地与远程定义不一致。

Navicat 17 本身不自动解决表结构冲突,所谓“协同”靠的是人对模型文件、同步策略和权限边界的共同约定,不是工具自动合并。
为什么结构同步后本地和远程表定义不一致?
Navicat 的「结构同步」只比对当前快照,不记录历史变更。如果 A 在本地改了 users.name 长度为 VARCHAR(100),B 同时在远程把同一字段改成 VARCHAR(255),同步时 Navicat 不会提示“两人改了同一字段”,而是直接按你选的「源→目标」方向覆盖——结果取决于谁先点同步、谁被设为源库。
- 结构同步默认不校验修改者/时间戳,也没有乐观锁机制
- 若未启用「生成 SQL 脚本预览」,你可能在点击「开始同步」前根本看不到它要删外键、改类型甚至 DROP COLUMN
- MySQL 8.0+ 下,
JSON字段在 Navicat 模型里显示正常,但若目标库是 MySQL 5.7,同步会静默失败(日志里只有「1 error」,需点开详情才看到 ERROR 1064)
如何让多人改模型不互相覆盖?
关键不是“怎么同步”,而是“谁有权力改、改完怎么确认、冲突怎么回退”。团队必须统一使用 .xml 模型导出物作为唯一可信来源,而不是直接共享 .nmodel 或 .nmw 文件。
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
- 每次模型变更后,右键模型工作区 →
Export Model to XML,存入 Git 仓库/models/目录,命名带语义如auth_service_v3_202610_add_phone_unique.xml - 禁止任何人跳过 XML 直接编辑
.nmodel后提交到 On-Prem Server——这等于绕过 Code Review,CI 流程无法拦截 DDL 风险 - Git 提交前运行脚本检查:
git diff HEAD~1 -- models/*.xml | grep -E "(,确认变更范围是否合理 - 若发现两人同时改了同一张表,不要强行合并 XML,应人工比对差异,以业务优先级决定保留哪版,并在 XML 注释里写明原因(如
)
同步前必须手动清理的三类默认陷阱
刚从旧 .nmw 导入或多人协作初期,模型里常埋着三类导致结构同步出错却不报明确错误的隐患:
-
fk_abc123类自动生成的外键名:每次导出 XML 都不同,Git Diff 全是噪音;应在模型中右键每条外键 → 「属性」→ 手动设固定名,如fk_user_profile_user_id - 字段注释未转成 SQL 注释:图形界面填的 Comment 不会进导出的 SQL,必须勾选导出选项
Export comments as SQL comments,并补上-- @desc 用户头像URL,支持HTTPS这类可读注释 - 目标数据库版本未锁定:模型属性里没设「MySQL 8.0」,却用了
DESCRIBE或窗口函数,同步到 MySQL 5.7 时直接失败;务必在模型右键 → 「模型属性」→ 「目标平台」选准版本
最易被忽略的点是:Navicat 的「结构同步」不校验字段逻辑一致性。比如 A 把 status 改成 TINYINT 并加枚举注释,B 同时把它改成 ENUM('active','inactive'),同步后字段类型可能变成 TINYINT,但应用层仍按 ENUM 解析——这种隐性不一致不会报错,上线后才暴露。










