本文目录

一、Jar包产生冲突的原因

二、排查Jar包冲突的方式

2.1 Maven Helper 插件

2.2 maven-enforcer-plugin插件

2.3 maven命令行

三、避免Jar包冲突

四、总结

在实际开发中，很多项目经常会使用 Maven 进行包管理。在 poml 文件中进行包依赖时，常存在引入一个 jar 包中默认依赖了其他的 jar 包的情况。这样很容易导致 jar 包冲突，从而产生一些诡异问题，如版本问题导致的类、方法找不到等。下面我们将聊聊具体关于依赖冲突产生的原因、排查方式以及解决的方案。

一、Jar包产生冲突的原因

我们知道 maven 有传递性依赖机制，举例来说，当我们需要依赖 A 的时候，就会在 pom.xml 中引入 A 的 jar 包；而 A 的 jar 包中依赖了 B 的 jar 包，这样 Maven 在解析 pom.xml 的时候，会依次将 A、B 的 jar包全部都引入进来。

比如：

A —> B —> C —> mapstruct 1.2.0(mapstruct 1.2.0)

E —> F —> mapstruct 1.3.0(mapstruct 1.3.0)

这样就会造成一个问题：

假设 pom.xml 文件中引入 A 与 E 两个依赖，按照上述的传递性依赖机制，与默认的依赖调解机制（第一：路径最近者优先；第二：第一声明优先），默认引用的是 mapstruct 1.2.0 版本的jar包，mapstruct 1.3.0 的jar包不会被引用。

如果 C 的 methodC 使用了新版本 mapstruct 1.3.0 才拥有的新类/新方法，程序中调用了 C 对应 mapstruct 1.3.0 的新类/新方法时，因为项目中引用的是 mapstruct 1.2.0，所以JVM去加载 Class 时就会发现 mapstruct 1.2.0 没有这个类，就会抛出 ClassNotFoundException；同样，调用mapstruct 1.2.0没有的新方法时会抛出 NoSuchMethodError。

二、排查Jar包冲突的方式

我们可以借助一些插件工具帮助找出冲突jar的具体位置。下面分享一下我在项目中排查并解决包冲突的两种方式。

Maven Helper 插件
maven-enforcer-plugin 插件
maven命令行

2.1 Maven Helper 插件

一般来说，使用IDEA插件是一个简便的排查方法

下载 Maven Helper，如何下载，可以去查看我的另一篇文章：【IntelliJ IDEA插件】值得推荐的Idea几十大优秀插件、神级超级牛逼插件推荐（自用，真的超级牛逼）

打开要查找冲突的 pom.xml

点击 Dependency Analyzer 窗口一目了然

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 1

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 2

2.2 maven-enforcer-plugin插件

Maven提供了Maven-Enforcer-Plugin插件 , 用来校验约定遵守情况，比依赖 jar 包的版本等等。当规则检查不通过的时候则会构建失败。

1、在pom.xml中引入该插件

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 3

rules内则是定义校验规则，通过配置可实现重复依赖检测。也支持自定义做一些其他检验如版本检验等。关于maven-enforcer-plugin插件rules的其他配置用法，感兴趣的朋友们，可以去查阅其相关的资料。

<rules>
    <requireMavenVersion>
        <version>3.0.4</version>
    </requireMavenVersion>
    <!--要求JDK版本)-->
    <requireJavaVersion>
        <version>6.0</version>
    </requireJavaVersion>
    <bannedDependencies>
        <!--是否检查传递性依赖(间接依赖)-->
        <searchTransitive>true</searchTransitive>
        <excludes>
            <exclude>junit:junit</exclude>
        </excludes>
        <message>must use TestNG</message>
    </bannedDependencies>
</rules>

2、配置好插件后进行项目构建，当存在包冲突时会在console中打印出来。

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 4

3、依据信息便可将不需要的jar包通过排除掉。

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI5OTAyNw_size_16_color_FFFFFF_t_70 5

2.3 maven命令行

通过Maven命名行的方式也是也不错的选择：

通过 mvn dependency:tree 可以在控制台上打印出依赖
通过 mvn dependency:tree -Dverbose -Dincludes=groupId:artifactId 只打印出你关心的Jar包的依赖关系
通过标签手动排除依赖

例如：

<!-- 内部引用 -->
<dependency>
    <groupId>com.iot.brain.platform</groupId>
    <artifactId>back-brain-platform-business</artifactId>
    <version>1.0-SNAPSHOT</version>
    <exclusions>
        <exclusion>
            <groupId>org.mapstruct</groupId>
            <artifactId>mapstruct</artifactId>
        </exclusion>
    </exclusions>
</dependency>

在引用guava时将com.google.errorprone这个包排除掉。

当然也有一些其他方法，对我来说第一种已经满足日常使用了。

三、避免Jar包冲突

最重要的还是要主动避免jar包冲突的情况，在父pom文件中利用，对依赖Jar包进行统一版本管理，一劳永逸。通常的做法是，在parent模块的pom文件中尽可能地声明所有相关依赖Jar包的版本，并在子pom中简单引用该构件即可。

例如在父pom文件中定义lombok的版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.10</version>
        </dependency>
    </dependencies>
</dependencyManagement>

然后在子moudle中：

<dependencies>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
    </dependency>
</dependencies>

子moudle中自动会引用版本为1.18.10的lombok Jar包。

四、总结

关于依赖冲突解决方式有三种：最短路径原则、声明优先原则、依赖排除。在没有手动进行依赖排除的情况下，会依据最短路径原则、声明优先原则来选择jar包。关于依赖冲突排查可借助如maven-enforcer-plugin 与Maven Helper 插件。根据实际情况及环境，选择组合最优的解决方案解决依赖冲突问题。

完结！