Liquibase启动失败：未找到变更日志文件，寻求解决方案

1. 核对Changelog路径配置 #

检查项目配置文件（application.properties或application.yml）中的Liquibase路径设置是否准确：

• properties格式示例：

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

• yml格式示例：

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

确保配置路径和文件实际存放位置完全匹配，比如文件直接放在src/main/resources下，路径需改为classpath:/db.changelog-master.xml。

2. 确认文件真实存在 #

检查src/main/resources（或项目资源目录）下，是否存在配置中指定的changelog文件，文件名、后缀（.xml/.yaml/.sql）必须和配置完全一致。

3. 检查构建工具的资源打包规则 #

• Maven：确认pom.xml没有排除该文件的配置，默认src/main/resources下的文件都会被打包进产物。
• Gradle：检查build.gradle的sourceSets配置是否包含资源目录：

  sourceSets {
      main {
          resources {
              srcDirs = ['src/main/resources']
          }
      }
  }
  

4. 注意路径大小写（Linux/macOS环境） #

在类Unix系统中，文件路径区分大小写，确保配置里的路径大小写和实际文件完全一致，比如DB.changelog.xml和db.changelog.xml会被识别为不同文件。

5. 用绝对路径排查类路径问题 #

如果以上步骤无效，可尝试使用本地绝对路径指定changelog文件，验证是否是类路径加载问题：

spring.liquibase.change-log=file:/xxx/your-project/src/main/resources/db/changelog/db.changelog-master.xml

若此方式能正常启动，说明类路径配置或打包环节存在问题，需重新检查资源打包逻辑。

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