Maven中的依赖冲突

如下图所示的场景：项目需要依赖jar包A（记作jarA）、jar包B（记作jarB），jarA和jarB同时需要依赖jar包C（记作jarC），不同的是，jarA需要的是jarC的1.0版本，jarB需要的是jarC的2.0版本。

那么，Maven会不会同时导入jarC1.0和jarC2.0？
当然不是！
对此，maven有两种策略，

• 第一种，短路径优选策略。
  
  第一条路径：项目依赖jarA，jarA依赖jarE，jarE依赖jarC1.0，即项目->jarA->jarE->jarC1.0。
  第二条路径：项目依赖jarB，jarB依赖jarC2.0，即项目->jarB->jarC2.0。
  短路径优先，所以最后maven只会导入jarC2.0，不会重复导入jarC1.0。
• 第二种，声明优先策略。
  如果引用路径长度相同，则采用声明优先策略。这就和依赖在pom文件中声明的先后顺序有关了。谁在前，就导入谁。
  

<!-- pom.xml -->
<dependency>
	<groupId></groupId>
	<artifactId>jarA</artifactId>
	<version></version>
</dependency>
<dependency>
	<groupId></groupId>
	<artifactId>jarB</artifactId>
	<version></version>
</dependency>

如上所示，因为jarA的声明在前，所以最后只会导入jarC1.0，不会重复导入jarC2.0。

好了，理论就是这样了。现在来看具体例子吧。

首先，新建一个基本的java项目，然后修改pom文件。

• 例1：添加依赖commons-logging:1.1。

<dependencies>
    <!-- https://mvnrepository.com/artifact/commons-logging/commons-logging -->
    <dependency>
        <groupId>commons-logging</groupId>
        <artifactId>commons-logging</artifactId>
        <version>1.1</version>
    </dependency>
</dependencies>

点击鼠标右键，Diagrams>Show Dependencies查看依赖树，如下所示。

可以看到，commons-logging:1.1依赖log4j:1.2.12，即commons-logging:1.1->log4j:1.2.12。

• 例2：添加依赖poi:3.5-FINAL。

<dependencies>
    <!-- https://mvnrepository.com/artifact/org.apache.poi/poi -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>3.5-FINAL</version>
    </dependency>
</dependencies>

查看依赖树，如下所示。

可以看到，关于依赖log4j，这里出现了一个冲突。

一条路径是：项目trains03->poi:3.5-FINAL->commons-logging:1.1->log4j:1.2.12。
另一条路径是：项目trains03->poi:3.5-FINAL->log4j:1.2.13。
短路径优先原则，所以maven最终只会导入log4j:1.2.13，所以在External Libraries里我们也只看到了log4j:1.2.13。

• 例3：添加依赖poi:3.5-FINAL和commons-beanutils:1.9.4

<dependencies>
    <!-- https://mvnrepository.com/artifact/org.apache.poi/poi -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>3.5-FINAL</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils -->
    <dependency>
        <groupId>commons-beanutils</groupId>
        <artifactId>commons-beanutils</artifactId>
        <version>1.9.4</version>
    </dependency>
</dependencies>

查看依赖树，如下图所示。

关于logg4j的冲突，例2中已经讲过了。

现在来看下关于commons-logging的冲突。

一条路径是：项目trains03->poi:3.5-FINAL->commons-logging:1.1。
另一条路径是：项目trains03->commons-beanutils:1.9.4->commons-logging:1.2。
以上两条路径长度是相同的，所以maven采用了声明优先策略。
pom文件中，poi声明在前，所以maven只导入了commons-logging:1.1。这也是为什么在External Libraries中只看到了commons-logging:1.1。

通常，软件版本都是向后兼容的。举例来说，commons-logging:1.1能提供的api，commons-logging:1.2也都能提供；但commons-logging:1.2能提供的功能，更低版本可能就不支持了。
所以，如果我们希望maven项目导入commons-logging:1.2，而不是commons-logging:1.1，有两个办法：

• 第一个办法：把commons-beanutils:1.9.4的声明前置。

<dependencies>
    <!-- https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils -->
    <dependency>
        <groupId>commons-beanutils</groupId>
        <artifactId>commons-beanutils</artifactId>
        <version>1.9.4</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/org.apache.poi/poi -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>3.5-FINAL</version>
    </dependency>
</dependencies>

• 第二个办法：使用<exclusions/>排除依赖。

<dependencies>
    <!-- https://mvnrepository.com/artifact/org.apache.poi/poi -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>3.5-FINAL</version>
        <exclusions>
            <exclusion>
                <groupId>commons-logging</groupId>
                <artifactId>commons-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils -->
    <dependency>
        <groupId>commons-beanutils</groupId>
        <artifactId>commons-beanutils</artifactId>
        <version>1.9.4</version>
    </dependency>
</dependencies>

使用<exclusions/>排除依赖还可以应用在这么一种场景中。
项目依赖jarA，jarA同时依赖jarB、jarC，但项目其实并不依赖jarB，如下图所示。

上图其实就是依赖传递。默认情况下，maven会将所有这些依赖，不论是直接依赖还是间接依赖全部下载到本地。
但是，既然项目不需要jarB，完全可以将其排除在外，这时就可以使用<exclusions/>，如下所示。

<dependencies>
    <dependency>
        <groupId>org.example</groupId>
        <artifactId>jarA</artifactId>
        <version>1.0-SNAPSHOT</version>
        <exclusions>
            <exclusion>
                <groupId>org.example</groupId>
                <artifactId>jarB</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

如此一来，依赖树就变成了下图右侧的样子了。