如何在Java依赖库中覆盖第三方依赖的properties配置文件？

根本原因 #

你遇到的加载优先级差异是类加载器的资源加载规则导致的：

• MessageResolver的硬编码逻辑是用类加载器读取类路径下的/swagger/validation/messages.properties，类路径下存在多个同名资源时，只会返回第一个被类加载器扫描到的资源
• 上层应用App-A的classes目录优先级永远高于所有依赖Jar包，所以App-A里放的同名文件会优先被加载，覆盖官方Jar里的配置
• Lib-A作为依赖Jar，和swagger-request-validator-core处于同级别依赖类路径，默认扫描顺序由依赖声明顺序决定，官方包如果声明在Lib-A之前，会优先加载官方的配置文件，Lib-A的配置就不会生效

可选解决方案 #

方案1：调整依赖声明顺序（操作最简单，稳定性一般） #

在Lib-A的pom.xml中，将swagger-request-validator-core的依赖声明位置放在Lib-A自身资源声明之后；如果是上层应用主动依赖，也可以在上层应用的pom.xml里把Lib-A的声明位置放在swagger-request-validator-core之前。
该方案的局限性是依赖顺序可能被其他传递依赖打乱，生产环境稳定性不高。

方案2：通过Maven Shade插件打包时覆盖配置（稳定性高，无业务侵入） #

在Lib-A的pom.xml中引入maven-shade-plugin，打包时直接删除官方Jar里的同名配置文件，保留Lib-A自定义的配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-shade-plugin</artifactId>
  <version>3.5.1</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>shade</goal>
      </goals>
      <configuration>
        <filters>
          <filter>
            <artifact>com.atlassian.oai:swagger-request-validator-core</artifact>
            <excludes>
              <exclude>swagger/validation/messages.properties</exclude>
            </excludes>
          </filter>
        </filters>
      </configuration>
    </execution>
  </executions>
</plugin>

打包完成后，Lib-A的Jar包内只会保留你自定义的messages.properties，上层应用依赖后无需额外配置就会加载自定义配置。

方案3：自定义MessageResolver替换默认实现（灵活度最高，不受资源加载规则限制） #

直接在Lib-A中构造自定义的MessageResolver实例，主动加载你自定义的配置文件，初始化校验器时传入该实例即可，完全绕开官方的硬编码加载逻辑：

// 自定义配置文件可以放在任意路径，不用和官方重名避免冲突
ResourceBundle customBundle = ResourceBundle.getBundle("custom-validation-messages");
MessageResolver customResolver = new MessageResolver(customBundle);

// 初始化校验器时传入自定义resolver
SwaggerRequestValidator validator = new SwaggerRequestValidator(swaggerSpec, customResolver);

该方案不受类路径资源优先级影响，后续调整配置也不需要修改打包规则，适合复杂依赖场景使用。

内容的提问来源于stack exchange，提问作者Sam Jing Wen