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文件中声明的先后顺序有关了。谁在前，就导入谁。
  

	
	jarA
	


	
	jarB
	

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

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

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

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

    
    
        commons-logging
        commons-logging
        1.1
    

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

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

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

    
    
        org.apache.poi
        poi
        3.5-FINAL
    

查看依赖树，如下所示。

可以看到，关于依赖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

    
    
        org.apache.poi
        poi
        3.5-FINAL
    
    
    
        commons-beanutils
        commons-beanutils
        1.9.4
    

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

关于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的声明前置。

    
    
        commons-beanutils
        commons-beanutils
        1.9.4
    
    
    
        org.apache.poi
        poi
        3.5-FINAL
    

• 第二个办法：使用排除依赖。

    
    
        org.apache.poi
        poi
        3.5-FINAL
        
            
                commons-logging
                commons-logging
            
        
    
    
    
        commons-beanutils
        commons-beanutils
        1.9.4
    

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

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

    
        org.example
        jarA
        1.0-SNAPSHOT
        
            
                org.example
                jarB
            
        
    

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