Java JAR包冲突

Java项目中多个JAR包含有相同的类，导致类加载冲突

症状

应用程序启动时出现ClassNotFoundException或NoClassDefFoundError
出现NoSuchMethodError或AbstractMethodError等错误
应用功能异常但没有明显错误日志

可能的原因

多个依赖包含相同类的不同版本
传递依赖导致的版本冲突
类加载顺序问题
不同的类加载器加载了同一个类的不同版本

解决方案

1. 检查Maven依赖树

步骤：

使用Maven命令查看依赖树
识别冲突的依赖
使用exclusion标签排除冲突的依赖

代码示例：

mvn dependency:tree -Dverbose

说明：

通过查看Maven依赖树，可以清晰地看到项目中所有的依赖关系，包括传递依赖，从而找出冲突的依赖。

2. 使用Maven依赖管理

步骤：

在pom.xml中使用dependencyManagement标签
明确指定每个依赖的版本
确保关键依赖使用一致的版本

代码示例：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.example</groupId>
      <artifactId>library</artifactId>
      <version>1.2.3</version>
    </dependency>
  </dependencies>
</dependencyManagement>

说明：

使用Maven的依赖管理功能，可以集中管理依赖版本，确保整个项目使用一致的依赖版本，避免版本冲突。

3. 使用Gradle依赖解析策略

步骤：

在build.gradle中配置依赖解析策略
使用resolutionStrategy强制使用特定版本
或使用exclude排除冲突依赖

代码示例：

configurations.all {
  resolutionStrategy {
    force 'com.example:library:1.2.3'
  }
}

说明：

Gradle提供了灵活的依赖解析策略，可以强制使用特定版本的依赖，或者排除冲突的依赖。

4. 使用Shade插件重定位类

步骤：

配置Maven Shade插件
使用relocate功能重命名冲突的类
打包时自动处理类冲突

代码示例：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-shade-plugin</artifactId>
  <version>3.2.4</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>shade</goal>
      </goals>
      <configuration>
        <relocations>
          <relocation>
            <pattern>com.google.common</pattern>
            <shadedPattern>shaded.com.google.common</shadedPattern>
          </relocation>
        </relocations>
      </configuration>
    </execution>
  </executions>
</plugin>

说明：

Maven Shade插件可以将依赖的类重命名并打包到应用程序中，避免类冲突问题。这对于无法修改依赖版本的情况特别有用。

Java JAR包冲突

症状

可能的原因

解决方案

1. 检查Maven依赖树

步骤：

代码示例：

说明：

2. 使用Maven依赖管理

步骤：

代码示例：

说明：

3. 使用Gradle依赖解析策略

步骤：

代码示例：

说明：

4. 使用Shade插件重定位类

步骤：

代码示例：

说明：

相关错误

标签