SpringBoot环境下Liquibase混合格式日志加载及JSON转换部署问题

1. 能否在Liquibase主文件中引用混合格式的变更日志文件？ #

当然可以！Liquibase本身就支持在主变更日志（无论主日志是XML、YAML、JSON还是SQL格式）中引用不同格式的子变更日志文件。它会自动识别每个文件的格式并完成解析，不需要额外配置。

举个实际例子，假设你的主日志是changelog-master.xml，完全可以同时引用YAML和JSON格式的子日志：

<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                   http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.9.xsd">
    <include file="changes/initial-setup.yaml" relativeToChangelogFile="true"/>
    <include file="changes/v2-add-user-table.json" relativeToChangelogFile="true"/>
</databaseChangeLog>

如果主日志是YAML格式，同样可以这么操作：

databaseChangeLog:
  - include:
      file: changes/initial-setup.xml
      relativeToChangelogFile: true
  - include:
      file: changes/v2-add-user-table.json
      relativeToChangelogFile: true

完全不用顾虑格式兼容问题，Liquibase的解析器会自动处理好这一切。

2. 从YAML切换到JSON：同时加载与转换部署问题 #

能否同时加载YAML和JSON格式的变更日志？ #

绝对没问题！正如第一个问题提到的，Liquibase原生支持混合格式，所以你可以逐步将YAML文件转换为JSON，不需要一次性完成全部迁移。这样就能省去大规模转换的麻烦，旧的YAML日志可以继续生效，新功能直接用JSON编写即可，完全不影响现有业务。

转换后的文件部署问题（哈希值相关） #

这里要明确一个关键信息：Liquibase计算的变更集哈希值是基于解析后的变更对象内容，而不是原始文件的格式。也就是说，只要转换后的JSON文件和原YAML文件的变更逻辑完全一致（比如表结构、字段定义、约束规则等都没有变化），哈希值就不会改变。部署时Liquibase会识别出这是同一个变更集，不会重复执行，也不会抛出错误。

如果转换过程中不小心修改了变更内容（比如字段类型写错、约束条件调整），哈希值才会变化，这时候Liquibase会认为是新的变更集，若原变更集已经执行过，可能会导致执行失败，所以转换时一定要仔细核对内容一致性。

SpringBoot环境下的配置说明 #

在SpringBoot中，你只需要保持原有Liquibase配置不变，确保所有变更日志文件（YAML和JSON格式）都在配置指定的路径下即可。

比如你的application.yml配置可能是这样的：

spring:
  liquibase:
    change-log: classpath:db/changelog/changelog-master.yaml
    enabled: true

只要主变更日志文件中正确引用了YAML和JSON的子文件，SpringBoot启动时Liquibase会自动加载并解析所有格式的文件，不需要额外配置。

如果你的主日志是直接指定多个文件（不过更推荐用主日志统一管理），也可以用逗号分隔：

spring:
  liquibase:
    change-log: classpath:db/changelog/old-yaml-changes.yaml,classpath:db/changelog/new-json-changes.json

不过这种方式不利于后续维护，还是建议用一个主日志文件来统一引用所有子变更日志。

内容的提问来源于stack exchange，提问作者Richard Collette