如何快速解决 java maven项目中jar冲突的问题

我们在java 项目开发中，经常会遇到jar包冲突的问题。会浪费我们很多时间。
如何快手定位问题是关键
在 Maven 项目中解决 Jar 冲突的常见方法如下

一、快速定位冲突

1. 查看依赖树

   mvn dependency:tree [-Dverbose] [-Dincludes=groupId:artifactId]
   

   • 使用 -Dverbose 显示详细冲突信息。
   • 使用 -Dincludes 过滤特定依赖（例如 -Dincludes=com.google.guava）。

2. IDEA 插件辅助（推荐）

   • 安装 Maven Helper 插件：
     • 通过 Analyze → Run Inspection by Name → Duplicated Classes 快速定位冲突。

二、解决方案

方法 1：手动排除依赖（常用）

在 pom.xml 中通过 <exclusions> 移除冲突的传递依赖：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>example-lib</artifactId>
    <version>1.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>conflict-group</groupId>
            <artifactId>conflict-artifact</artifactId>
        </exclusion>
    </exclusions>
</dependency>

方法 2：统一版本（推荐）

在父 pom.xml 的 <dependencyManagement> 中强制指定版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
            <version>32.0.0-jre</version> <!-- 指定统一版本 -->
        </dependency>
    </dependencies>
</dependencyManagement>

方法 3：依赖优先级调整

Maven 遵循 “最近优先”（nearest wins） 原则，调整依赖声明的顺序或层级。

方法 4：强制覆盖版本

在 <properties> 中定义版本号，全局替换：

<properties>
    <guava.version>32.0.0-jre</guava.version>
</properties>

三、高级工具

1. maven-enforcer-plugin

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-enforcer-plugin</artifactId>
       <version>3.0.0</version>
       <executions>
           <execution>
               <id>enforce</id>
               <configuration>
                   <rules>
                       <dependencyConvergence/>
                   </rules>
               </configuration>
               <goals>
                   <goal>enforce</goal>
               </goals>
           </execution>
       </executions>
   </plugin>
   

   • 运行 mvn enforcer:enforce 检查冲突。

2. IDE 分析

   • 在 IntelliJ 中右键点击冲突的类 → Find Usages → Show Dependencies。

四、典型场景示例

场景：Spring 版本冲突

1. 通过 dependency:tree 发现多个 Spring 模块版本不一致。
2. 在父 pom.xml 的 <dependencyManagement> 中统一版本：

   <dependency>
       <groupId>org.springframework</groupId>
       <artifactId>spring-core</artifactId>
       <version>5.3.20</version>
   </dependency>
   

场景：日志框架冲突（SLF4J + Log4j）

排除冲突的传递依赖：

<dependency>
    <groupId>org.apache.hadoop</groupId>
    <artifactId>hadoop-common</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
        </exclusion>
    </exclusions>
</dependency>

五、最后总结步骤

1. 定位冲突：使用 dependency:tree 或 Maven Helper。
2. 排除依赖：通过 <exclusions> 移除冲突 Jar。
3. 统一版本：在父 pom.xml 中全局管理版本。
4. 验证结果：重新编译并运行测试。

通过以上方法，大部分的 Jar 冲突问题可快速解决。