Navicat不能解析Liquibase changelog文件，因其仅识别数据库当前状态和SQL文本，不支持XML/YAML/JSON格式及changeSet语义；正确用法是Liquibase执行变更后，用Navicat比对终态结构与基准源以验证结果。
navicat 本身不能直接读取或执行 liquibase 的 changelog 文件，也不能自动识别 liquibase 管理的变更历史；它只能作为辅助比对工具，验证 liquibase 执行后的实际结构是否符合预期。
为什么不能把 Liquibase changelog 直接丢给 Navicat 解析
Navicat 不解析 XML/YAML/JSON 格式的 Liquibase 变更集，也不理解 changeSet 的 id 和 author 语义。它只认数据库当前状态（通过 INFORMATION_SCHEMA 抓取）和 SQL 文本（如 mysqldump 导出的 DDL）。如果你把一个未执行的 changelog.xml 拖进 Navicat，它会报错“无法识别文件格式”或静默忽略。
常见错误现象：
- 右键
changelog.xml→ “执行” → 提示“不支持的文件类型” - 用 Navicat 导入该文件 → 加载为空，或误判为数据导入（尝试插入 XML 内容到表）
- 期待 Navicat 显示“待执行变更列表” → 实际无此功能
真正可行的配合路径：Liquibase 执行后，用 Navicat 做终态校验
这是最稳定、可复现的协作方式：Liquibase 负责变更执行与顺序控制，Navicat 负责人工确认结果是否符合预期。
操作要点：
- 确保 Liquibase 已成功运行
liquibase update，且databasechangelog表中新增了对应changeSet记录 - 用 Navicat 连接**执行后的目标库**，再连接一个**可信基准源**（例如：前一天的结构备份 SQL 文件，或 Git 中最新提交的
schema.sql快照） - 右键基准源 → “结构同步” → 目标选刚更新完的库 → 在“对象选择”页仅勾选
Tables，取消Stored Procedures等干扰项 - 点击“选项”，勾选“忽略列顺序”和“忽略默认值引号”，避免因格式差异触发误报
- 预览 SQL 时重点检查：
ALTER TABLE ... ADD COLUMN是否与changelog中一致；MODIFY COLUMN类型变更是否在预期范围内（如VARCHAR(100)→VARCHAR(191)）
用 Navicat 快速定位 Liquibase 意外跳过或失败的变更
当怀疑某次 changeSet 没生效（比如字段没加、索引没建），不要翻日志，直接查元数据一致性。
典型排查步骤：
- 在 Liquibase 项目中找到对应
changeSet id="xxx"，确认它声明的操作（如addColumn、createIndex） - 在 Navicat 中执行查询：
SELECT * FROM databasechangelog WHERE ID = 'xxx'，确认MD5SUM非空且DATEEXECUTED是最近时间 - 若记录存在但结构未变：用 Navicat 查该表的
CREATE TABLE语句，肉眼比对字段/索引是否缺失；也可导出 DDL 后用diff工具对比 - 若记录不存在：说明
liquibase update根本没跑这组，检查include路径、profile 是否匹配、或是否被preConditions拦截（例如dbms="postgresql"却连了 MySQL）
绕过 Navicat 的权限陷阱：否则结构同步卡死在“正在获取表元信息”
Navicat 结构同步依赖底层元数据查询，缺权限会假死或返回空差异，不是 Liquibase 的问题，而是连接配置不到位。
必须显式授予的最小权限（以 MySQL 为例）：
-
SELECToninformation_schema.TABLES,COLUMNS,STATISTICS,KEY_COLUMN_USAGE -
SELECTon 目标数据库本身（不能只给*，要写成GRANT SELECT ON `myapp_db`.* TO 'navi_user'@'%'） -
LOCK TABLESon 目标库（否则同步过程无法锁定表获取一致性快照） - 注意：Navicat 16.3+ 要求两个连接都处于“已连接”状态（非仅“已保存”），断开任一端都会终止抓取
最容易被忽略的是 LOCK TABLES —— 它不包含在 SHOW DATABASES 或 USAGE 权限里，必须单独 GRANT。线上环境常因安全策略禁用该权限，此时应改用 mysqldump + diff 方案，而非强依赖 Navicat 同步界面。
