配置Spring Boot使用XML格式Liquibase变更日志时遇异常

1. 核对配置键名与格式 #

确保application-local.yml中的Liquibase配置完全正确，YAML格式对缩进敏感，正确配置示例：

spring:
  liquibase:
    change-log: classpath:/liquibase/db.changelog-master.xml

• 检查拼写错误：比如误将change-log写成changelog（Spring Boot官方配置键为带连字符的change-log）
• 确认缩进层级：liquibase必须嵌套在spring节点下，缩进错误会导致配置不被加载

2. 排查配置覆盖问题 #

• 检查根目录application.yml：如果该文件中设置了spring.liquibase.change-log: classpath:/db/changelog/db.changelog-master.yaml，需确认local配置是否正确覆盖了这个值（Spring Boot中Profile配置优先级高于默认配置，但格式错误会导致覆盖失败）
• 检查启动参数/环境变量：查看启动命令是否添加了--spring.liquibase.change-log参数，或系统环境变量中是否设置了SPRING_LIQUIBASE_CHANGE_LOG，这些会优先于配置文件中的值

3. 验证配置加载状态 #

在启动类中添加配置打印逻辑，确认实际加载的Liquibase配置：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

@Component
public class ConfigChecker implements CommandLineRunner {

    @Value("${spring.liquibase.change-log:未加载到配置}")
    private String liquibaseChangelog;

    @Override
    public void run(String... args) throws Exception {
        System.out.println("当前Liquibase变更日志路径：" + liquibaseChangelog);
    }
}

启动应用后查看控制台输出，确认配置是否正确加载

4. 检查依赖与自动配置 #

• 确认引入Spring Boot官方的Liquibase starter：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-liquibase</artifactId>
</dependency>

避免引入独立Liquibase依赖导致配置不兼容

• 检查启动类是否排除了Liquibase自动配置：如果存在@SpringBootApplication(exclude = LiquibaseAutoConfiguration.class)，会导致配置失效（你的场景中应用在查找默认YAML文件，说明自动配置已生效，此步骤可快速排除极端情况）

5. 清理缓存与构建目录 #

• 执行mvn clean install（Maven项目）或./gradlew clean build（Gradle项目），彻底清理构建缓存与旧编译文件
• 清理IDE缓存：比如IntelliJ IDEA可通过File -> Invalidate Caches...清理缓存并重启IDE

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