快捷導(dǎo)航

詳解maven依賴沖突以及解決方法

更新時間：2020年06月23日 14:12:30 作者：linyb極客之路

這篇文章主要介紹了maven依賴沖突以及解決方法，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

什么是依賴沖突

依賴沖突是指項目依賴的某一個jar包，有多個不同的版本，因而造成類包版本沖突

依賴沖突的原因

依賴沖突很經(jīng)常是類包之間的間接依賴引起的。每個顯式聲明的類包都會依賴于一些其它的隱式類包，這些隱式的類包會被maven間接引入進來，從而造成類包沖突

如何解決依賴沖突

首先查看產(chǎn)生依賴沖突的類jar，其次找出我們不想要的依賴類jar，手工將其排除在外就可以了。具體執(zhí)行步驟如下

1、查看依賴沖突

a、通過dependency:tree是命令來檢查版本沖突

mvn -Dverbose dependency:tree

當(dāng)敲入上述命令時，控制臺會出現(xiàn)形如下內(nèi)容

[INFO] org.example:hello:jar:1.0-SNAPSHOT
[INFO] +- org.springframework:spring-context:jar:5.2.7.RELEASE:compile
[INFO] | +- (org.springframework:spring-aop:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO] | +- org.springframework:spring-beans:jar:5.2.7.RELEASE:compile
[INFO] | | \- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for duplicate)
[INFO] | +- org.springframework:spring-core:jar:5.2.7.RELEASE:compile
[INFO] | | \- org.springframework:spring-jcl:jar:5.2.7.RELEASE:compile
[INFO] | \- org.springframework:spring-expression:jar:5.2.7.RELEASE:compile
[INFO] | \- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for duplicate)
[INFO] \- org.springframework:spring-aop:jar:5.2.0.RELEASE:compile
[INFO] +- (org.springframework:spring-beans:jar:5.2.0.RELEASE:compile - omitted for conflict with 5.2.7.RELEASE)
[INFO] \- (org.springframework:spring-core:jar:5.2.0.RELEASE:compile - omitted for conflict with 5.2.7.RELEASE)

其中omitted for duplicate表示有jar包被重復(fù)依賴，最后寫著omitted for conflict with xxx的，說明和別的jar包版本沖突了，而該行的jar包不會被引入。比如上面有一行最后寫著omitted for conflict with 5.2.7.RELEASE，表示spring-core 5.2.0版本不會被項目引用，而spring-core 5.2.7版本會被項目引用

b、如果是idea，可以安裝maven helper插件來檢查依賴沖突

maven helper插件安裝成功，點開pom.xml會發(fā)現(xiàn)多了一個Dependency Analyzer視圖，如下

上面按鈕的圖標(biāo)含義如下

Conflicts（查看沖突）
All Dependencies as List（列表形式查看所有依賴）
All Dependencies as Tree（樹形式查看所有依賴）

上圖說明有3個jar存在沖突，點擊沖突的jar，可以查看和哪個jar產(chǎn)生沖突，如下圖

2、解決沖突

項目的pom.xml形如下

 <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>5.2.7.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>5.2.0.RELEASE</version>
    </dependency>


  </dependencies>

通過查看依賴樹，我們知道項目會引用5.2.7.RELEASE的spring core jar包，而不會引用5.2.0的jar包，如果我們想用5.2.0版本的spring core包，我們該如何做？

a、使用第一聲明者優(yōu)先原則

誰先定義的就用誰的傳遞依賴，即在pom.xml文件自上而下，先聲明的jar坐標(biāo)，就先引用該jar的傳遞依賴。因此我們?nèi)绻褂?.2.0版本的spring core包，我們可以改成如下聲明

 <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>5.2.0.RELEASE</version>
    </dependency>
    
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>5.2.7.RELEASE</version>
    </dependency>

  </dependencies>

查看依賴樹

[INFO] org.example:hello:jar:1.0-SNAPSHOT
[INFO] +- org.springframework:spring-aop:jar:5.2.0.RELEASE:compile
[INFO] | +- org.springframework:spring-beans:jar:5.2.0.RELEASE:compile
[INFO] | | \- (org.springframework:spring-core:jar:5.2.0.RELEASE:compile - omitted for duplicate)
[INFO] | \- org.springframework:spring-core:jar:5.2.0.RELEASE:compile
[INFO] | \- org.springframework:spring-jcl:jar:5.2.0.RELEASE:compile
[INFO] \- org.springframework:spring-context:jar:5.2.7.RELEASE:compile
[INFO] +- (org.springframework:spring-aop:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO] +- (org.springframework:spring-beans:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO] +- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO] \- org.springframework:spring-expression:jar:5.2.7.RELEASE:compile
[INFO] \- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)

通過依賴樹，我們可以看到項目已經(jīng)引入5.2.0版本的spring core包

b、使用路徑近者優(yōu)先原則

即直接依賴級別高于傳遞依賴。因此我們可以在最先的pom.xml添加如下內(nèi)容

 <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>5.2.7.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>5.2.0.RELEASE</version>
    </dependency>

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



  </dependencies>

通過上圖可以看到項目引入是 spring core 5.2.0的包

c、排除依賴

排除依賴如果是idea，可以使用maven helper插件進行排除。點開pom.xml，切換到Dependency Analyzer視圖，選擇All Dependencies as Tree，點擊要排除的jar，右鍵會出現(xiàn)Execlude選項，如下

它產(chǎn)生的效果和如下配置是一樣

 <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>5.2.7.RELEASE</version>
      <exclusions>
        <exclusion>
          <artifactId>spring-core</artifactId>
          <groupId>org.springframework</groupId>
        </exclusion>
      </exclusions>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>5.2.0.RELEASE</version>
    </dependency>

  </dependencies>

通過上圖可以看到項目引入是 spring core 5.2.0的包

4、版本鎖定

使用dependencyManagement 進行版本鎖定，dependencyManagement可以統(tǒng)一管理項目的版本號，確保應(yīng)用的各個項目的依賴和版本一致。

如果我們項目中只想使用spring core 5.2.0的包，pom.xml可以改為如下

<dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.2.0.RELEASE</version>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>5.2.7.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>5.2.0.RELEASE</version>
    </dependency>

  </dependencies>