Quarkus版本升级后原生镜像启动失败：Liquibase主文件重复问题求助

从你的报错信息来看，这个问题大概率不是Quarkus的Bug，而是升级过程中Liquibase集成的行为变化，或者项目/依赖中存在重复的changelog资源导致的。下面是具体的排查和解决思路：

1. 先确认重复文件的真实来源 #

首先你需要明确这两个同名文件到底来自哪里——是你自己的项目中重复打包了，还是某个第三方依赖也包含了同名的liquibase-changelog-master.yml？

可以通过以下方式排查：

• 构建项目后，查看target/classes/db/changelog/目录，确认是否存在多个同名文件；
• 如果是原生镜像，执行jar tf target/[你的应用名]-runner.jar | grep liquibase-changelog-master.yml，查看输出的文件路径细节，判断是否有来自第三方依赖的重复资源。

2. 调整Liquibase配置，精准定位目标文件 #

你已经尝试过修改quarkus.liquibase.change-log，但可能需要更精确的配置方式：

• 如果目标文件是你项目自身的，尝试在配置中明确指定classpath:前缀并配合资源定位参数，比如：

  quarkus.liquibase.change-log=classpath:/db/changelog/liquibase-changelog-master.yml?relativeTo=your-project-artifact-id.jar
  

• 或者干脆修改你自身changelog文件的路径，比如改成db/changelog/project-specific-liquibase-changelog.yml，避免和依赖中的文件重名，然后更新配置指向新路径。

3. 排除第三方依赖中的重复资源 #

如果排查后发现是某个依赖引入了同名的changelog文件，可以通过Maven/Gradle排除该依赖的资源：

• Maven示例：在对应依赖中添加资源排除规则

  <dependency>
      <groupId>com.example</groupId>
      <artifactId>problematic-dependency</artifactId>
      <version>x.y.z</version>
      <exclusions>
          <exclusion>
              <groupId>*</groupId>
              <artifactId>*</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

  或者更精准地排除特定资源（如果构建工具支持）。

4. 清理构建缓存并重新构建 #

有时候旧的构建缓存会导致重复资源被保留，执行干净的原生构建命令：

mvn clean package -Dnative -Dquarkus.native.container-build=true

（如果是Gradle则用./gradlew clean build -Dquarkus.package.type=native）

5. 了解Quarkus升级带来的Liquibase版本变化 #

Quarkus 2.11.1.Final对应的Liquibase版本比2.6.2.Final高很多（从Liquibase 4.x的早期版本升级到了4.9.x左右），Liquibase自身的资源加载逻辑可能发生了变化——旧版本可能会忽略重复的同名资源，而新版本会严格检测并抛出错误。这也是为什么升级后才出现这个问题的原因。

总结来说，这个问题的核心是classpath中存在重复的Liquibase changelog文件，通过定位来源、调整配置或排除重复资源就能解决。

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