如何排除第三方Fat Jar中已解压的依赖类解决日志冲突？

由于ThirdParty是Fat Jar，内部依赖已被解压为类文件，Maven常规的依赖排除规则对这类场景无效，可通过以下几种方式处理：

1. 使用Maven Shade插件过滤冲突类 #

Shade插件能在打包MyApp时，直接移除ThirdParty Jar中指定的冲突类。在pom.xml中添加如下配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <filters>
              <!-- 排除ThirdParty中reload4j及SLF4J绑定类 -->
              <filter>
                <artifact>你的ThirdParty的groupId:ThirdParty的artifactId</artifact>
                <excludes>
                  <exclude>org/apache/log4j/**</exclude>
                  <exclude>org/slf4j/impl/StaticLoggerBinder.class</exclude>
                  <exclude>org/slf4j/impl/StaticMDCBinder.class</exclude>
                  <exclude>org/slf4j/impl/StaticMarkerBinder.class</exclude>
                </excludes>
              </filter>
              <!-- 排除引发冲突的log4j-slf4j转换类 -->
              <filter>
                <artifact>你的ThirdParty的groupId:ThirdParty的artifactId</artifact>
                <excludes>
                  <exclude>org/apache/logging/log4j/slf4j/**</exclude>
                </excludes>
              </filter>
            </filters>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

注意替换配置中的你的ThirdParty的groupId:ThirdParty的artifactId为实际依赖坐标，打包时插件会自动移除指定的冲突类。

2. 手动修改ThirdParty Jar #

直接解压ThirdParty Jar，删除其中的冲突类文件后重新打包：

• 解压命令：jar xf ThirdParty.jar
• 删除冲突目录/文件：比如org/apache/log4j整个目录、org/slf4j/impl下的绑定类、org/apache/logging/log4j/slf4j相关类
• 重新打包：jar cf ThirdParty-cleaned.jar -C ./解压后的目录/ .

将修改后的ThirdParty-cleaned.jar作为依赖引入MyApp即可，缺点是后续ThirdParty版本更新时需要重复操作。

3. 自定义类加载器（适合特殊场景） #

继承URLClassLoader并重写loadClass方法，在加载类时跳过ThirdParty中的冲突日志类：

• 当检测到要加载的类属于org.apache.log4j、org.slf4j.impl等冲突包时，优先从MyApp自身依赖加载，或直接跳过从ThirdParty加载
• 启动MyApp时指定使用该自定义类加载器

这种方式复杂度较高，仅适合无法修改打包流程的场景。

4. 配合Spring Boot日志配置强化优先级 #

在MyApp的application.properties中强制指定日志实现，减少冲突概率：

# 强制使用log4j2作为SLF4J绑定
logging.config=classpath:log4j2.xml
slf4j.provider=org.apache.logging.slf4j.SLF4JServiceProvider

该方法需结合前面的类过滤方案使用，仅靠配置无法完全消除类路径中存在多个绑定类的警告。

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