maven依赖冲突问题

什么是依赖冲突

依赖冲突是指项目依赖的某一个jar包，有多个不同的版本，因而造成了包版本冲突。

maven依赖原则

maven依赖主要有两大原则：路径最近者优先，声明者优先

实例演示如何解决依赖冲突

在当前项目中，我即引用了org.apache.poi，又引用了com.alibaba的easyexcel。

   <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>3.10.1</version>
   </dependency>
   <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>easyexcel</artifactId>
        <version>2.2.8</version>
   </dependency>

 我们发现在SpringBoot启动的时候就报NoClassDefFoundError异常了。

这就是依赖冲突导致的异常报错。

为什么会这样呢，我们可以通过idea看下,打开maven菜单，点击show dependencies。

我当前的easyexcel引入的poi是3.17版本的，但是因为根据maven依赖原则，实际引入的poi版本确实是3.10.1版本的。

而DefaultTempFileCreationStrategy这个类在3.10.1这个版本并没有，只有3.17版本才有，所以报了这个错误。

如何排除依赖

关键字:exclusions

exclusions可以包含一个或者多exclusion子元素，因此可以排除一个或者多个传递性依赖

需要注意的是，声明exclusion的时候只需要groupld和artifactld,而不需要要version元素。

   <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>3.10.1</version>
            <!--排除poi依赖-->
        <exclusions>
            <exclusion>
                <artifactId>poi</artifactId>
                <groupId>org.apache.poi</groupId>
             </exclusion>
        </exclusions>
   </dependency>

那我们如何从众多jar包中准确找到冲突的依赖呢？

答案就是：Maven Helper插件

在pom文件中看到 dependency analyzer标志，说明maven helper插件就安装成功了。

 

点击dependency analyzer之后就会进入到下面的页面

 

从图中可以看出有哪些jar存在冲突，存在冲突的情况下最终采用了哪个依赖的版本。标红的就是冲突版本，白色的是当前的解析版本。

如果我们想保留标红的版本，那我们可以标白区域右击选择排除(Exclude)

然后我们再来看pom文件,发现在org.apache.poi中已经移除了poi了。

   <dependency>
       <groupId>org.apache.poi</groupId>
       <artifactId>poi-ooxml</artifactId>
       <version>3.10.1</version>
       <exclusions>
          <exclusion>
             <artifactId>poi</artifactId>
             <groupId>org.apache.poi</groupId>
           </exclusion>
       </exclusions>
    </dependency>
    <dependency>
       <groupId>com.alibaba</groupId>
       <artifactId>easyexcel</artifactId>
       <version>2.2.6</version>
    </dependency>

 我们发现最终的版本最终已经变成3.17版本，现在再启动就不会报错了，成功解决依赖冲突问题。

技巧：

一般我们在解决依赖冲突的时候，都会选择保留jar高的版本，因为大部分jar在升级的时候都会做到向下兼容，所以只要保留高的版本就不会有什么问题。

但是有些包，版本变化大没法去做向下兼容，高版本删了低版本的某些类或者某些方法，那么这个时候就不能一股脑的去选择高版本，但也不能选择低版本。只能选择升级低版本或者降低高版本的等级。