Spring Boot与Liquibase CLI迁移时MD5校验和不一致问题

我通过Spring Boot Starter（3.4.2版本）集成Liquibase（4.27.0版本）执行数据库迁移，为复现MD5校验和不匹配的问题，手动使用同版本Liquibase CLI执行了以下操作：

项目依赖配置 #

<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.4.2</version>

CLI执行命令 #

cd <path-to-my-project>/src/main/resources; \
liquibase \
--search-path=. \
changelog-sync-sql \
--changelog-file=db.changelog-master.xml \
--url=jdbc:postgresql://localhost:5432/mydb \
--default-schema-name=public \
--password=test\
--username=test

因使用--search-path时Liquibase的includeAll选项存在问题，我已将src/main/resources/db/changelog/db.changelog-master.xml移至src/main/resources/db.changelog-master.xml，主changelog内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<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-3.2.xsd">
    <preConditions>
        <dbms type="postgresql"/>
    </preConditions>
    <includeAll path="db/changelog/migration"/>
</databaseChangeLog>

操作后Spring Boot与CLI计算的MD5哈希值仍不一致，可能的原因如下：

• 逻辑路径标识差异：Liquibase计算MD5时会纳入变更文件的逻辑路径。Spring Boot从classpath加载资源，逻辑路径以classpath:开头；CLI从文件系统加载，逻辑路径是相对于--search-path的相对路径。即使物理文件内容一致，路径标识的差异会直接导致MD5结果不同。
• 文件换行符/编码差异：如果变更文件在不同操作系统下编辑（比如Windows的CRLF与Unix的LF换行符），或文件编码不一致，会导致文件实际内容存在细微差别。Spring Boot和CLI读取文件时的编码处理逻辑可能存在差异，进一步放大这个问题。
• 资源过滤/占位符替换差异：如果Maven/Gradle配置了资源过滤（比如替换文件中的${xxx}占位符），Spring Boot运行时加载的是编译后过滤完成的文件，而CLI直接读取src/main/resources下的原始文件，两者内容不一致会导致MD5不匹配。
• 隐式配置参数差异：Spring Boot自动配置的Liquibase会添加默认参数（如liquibase.contexts、liquibase.labels），而CLI命令未显式指定这些参数时，Liquibase的变更集筛选逻辑不同，导致参与MD5计算的变更集范围不一致。
• 类路径依赖差异：虽然Liquibase版本相同，但Spring Boot集成的Liquibase依赖Spring类加载器及相关组件，CLI则使用独立类路径。某些依赖（如数据库驱动版本）的细微差异，可能导致Liquibase解析变更集、生成校验和的逻辑出现偏差。

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