1、簡介

1.1、什么是依賴沖突

依賴沖突是指：在 Maven 項目中，當多個依賴包，引入了同一份類庫的不同版本時，可能會導致編譯錯誤或運行時異常。

1.2、依賴沖突的原因

我們在 Maven 項目的 Pom 中 一般會引用許許多多的 Dependency。例如，項目A有這樣的依賴關系：

A -> C -> X(1.0)
B -> D -> X(2.0)

X是A的 傳遞性依賴 ，但是兩條依賴路徑上有兩個版本的X,那么哪個X會被 Maven 解析使用呢? 兩個版本都被解析顯然是不對的，因為那會造成依賴重復，因此必須選擇一個。

在絕對大多數情況下，依賴沖突問題并不需要我們考慮，Maven 工具會自動根絕依賴原則選擇，這里我們先假設最終引用的 X(1.0) 版本，

1、你想如果B引用 X(2.0) 的新創建的類，但因為最終被解析的是 X(1.0)，所以就會出現很典型的 NoClassDefFoundError 或 ClassNotFoundException 依賴沖突報錯。

2、如果B引用 X(2.0) 的新創建的方法，但因為最終被解析的是 X(1.0)，所以就會拋出 NoSuchMethodError 系統異常。

但換種角度，如果最終解析的是 X(2.0)，就沒問題了嗎？

1、如果 X(2.0) 刪掉了 X(1.0) 的一些類，但A已經引用了，同樣也會報 NoClassDefFoundError 或者 ClassNotFoundException 錯誤。

2、如果 X(2.0) 刪掉了 X(1.0) 的一些方法，但A已經引用了，同樣也會報 NoSuchMethodError 錯誤。

所以說具體問題還需具體分析，到底采用哪個版本還需要看實際項目。也可能我們需要升級對應的A或者B的版本才能解決問題。

2、Maven 依賴原則

2.1、層級優先原則(路徑最近者優先)

在同一個 Pom 內，相同 Jar 不同版本，根據依賴的路徑長短來決定引入哪個依賴。

舉例

依賴鏈路一：A -> B -> C -> X(1.0)
依賴鏈路二：F -> D -> X(2.0)

該例中 X(1.0) 的路徑長度為3,而 X(2.0) 的路徑長度為2,因此 X(2.0) 會被解析使用。依賴調解第一原則不能解決所有問題，比如這樣的依賴關系：

A -> B -> Y(1.0)
c -> D -> Y(2.0)

Y(1.0) 和 Y(2.0) 的依賴路徑長度是一樣的，都為2。Maven 定義了依賴調解的第二原則：

2.2、聲明優先原則(第一聲明者優先)

在依賴路徑長度相等的前提下，在同一個 Pom 中，間接依賴聲明的順序決定了誰會被解析使用，順序最前的那個依賴優勝。該例中，如果A的依賴聲明在C之前，那么 Y (1.0) 就會被解析使用.

比如 我在 demo01 中引入了 demo02 和 demo03，demo02 和 demo03 都引入了 Lombok 的依賴

圖片

demo02 和 demo03 換個順序

圖片

2.3、特殊情況

• 子Pom內聲明的優先于父 Pom 中的依賴。
• 同Pom內出現不同版本的相同類庫時，后聲明的會覆蓋先聲明的。也就是在同一個Pom里配置了相同資源的不同版本的直接依賴，后配置的覆蓋先配置的。比如下邊這個例子

圖片

• 調換下順序就是引用的4.12的依賴。

圖片

3、如何排除依賴

我們先來解釋下什么是傳遞性依賴

3.1、什么是傳遞性依賴

比如當我們項目中，引用了A的依賴,A的依賴通常又會引入B的 Jar 包，B可能還會引入C的 Jar 包。

這樣，當你在 pom.xml 文件中添加了A的依賴，Maven 會自動的幫你把所有相關的依賴都添加進來。

就這樣一層層的，Maven 會自動的幫你把所有相關的依賴都添加進來。傳遞性依賴會給項目引入很多依賴，簡化項目依賴管理，但是也會帶來問題。

最明顯的就是容易發生依賴沖突。

3.2、如何排除依賴

這種情況下，想要解決依賴沖突，可以靠升級/降級某些依賴項的版本，從而讓不同依賴引入的同一類庫，保持一致的版本號。另外，還可以通過隱藏依賴、或者排除特定的依賴項來解決問題。

3.2.1、<exclusions>標簽

Exclusions是主動斷開依賴的資源，被排除的資源無需指定版本—指不需要

也就是說可以包含一個或者多 Exclusion 子元素，因此可以排除一個或者多個傳遞性依賴。需要注意的是，聲明 Exclusion 的時候只需要 Groupld 和 Artifactld ,而不需要要 Version 元素。

用法示例：

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-web</artifactId>
  <version>5.1.8.RELEASE</version>
  <exclusions>
    <!-- 排除web包依賴的beans包 -->
    <exclusion>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
    </exclusion>
  </exclusions>
</dependency>

3.2.2、<optional>標簽

該標簽即是“隱藏依賴”的開關,指對外隱藏當前所依賴的資源---指不透明：

• true：開啟隱藏，當前依賴不會向其他工程傳遞，只保留給自己用；
• false：默認值，表示當前依賴會保持傳遞性，其他引入當前工程的項目會間接依賴。

用法示例：
<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-aop</artifactId>
  <version>5.1.8.RELEASE</version>
  <optional>true</optional>
</dependency>

3.2.2.1、上邊兩種<exclusions>標簽和``<optional>標簽的區別

• A依賴B,B依賴C , C 通過依賴傳遞會被 A 使用到，現在要想辦法讓 A 不去依賴 C
• 可選依賴是在B上設置 <optional> , A 不知道有 C 的存在，代表這個依賴是否需要被發現。這種適用于**可以修改B的配置文件的情況下**** 先看默認情況，也就是false

圖片

• 改為 true 后

圖片

• 排除依賴是在A上設置 <exclusions> , A 知道有 C 的存在，主動將其排除掉。代表這個依賴已經被發現，但自己是否需要引用。這種適用于不能修改B的配置文件的情況下

圖片

3.2.3、Maven 聚合工程 統一管理版本

聚合工程，即是指：一個項目允許創建多個子模塊，多個子模塊組成一個整體，可以統一進行項目的構建。要弄明白聚合工程，得先清楚“父子工程”的概念：

• 父工程：不具備任何代碼、僅有pom.xml的空項目，用來定義公共依賴、插件和配置；
• 子工程：編寫具體代碼的子項目，可以繼承父工程的配置、依賴項，還可以獨立拓展。

而Maven聚合工程，就是基于父子工程結構，來將一個完整項目，劃分出不同的層次，這種方式可以很好的管理多模塊之間的依賴關系，以及構建順序，大大提高了開發效率、維護性。

為了防止不同子工程引入不同版本的依賴，在父工程中，統一對依賴的版本進行控制，規定所有子工程都使用同一版本的依賴，可以使用<dependencyManagement>標簽來管理。

• <dependencies>：定義強制性依賴，寫在該標簽里的依賴項，子工程必須強制繼承；
• <dependencyManagement>：定義可選性依賴，該標簽里的依賴項，子工程可選擇使用。

子工程在使用<dependencyManagement>中已有的依賴項時，不需要寫<version>版本號，版本號在父工程中統一管理，這樣做的好處在于：以后為項目的技術棧升級版本時，不需要單獨修改每個子工程的POM，只需要修改父POM文件即可，減少了版本沖突的可能性。

4、Maven Helper 插件分析jar包沖突

如果你的項目中依賴許許多多的 Jar ，肉眼排查就沒那么方便了，這里推薦一個 Maven 管理插件

圖片

在 Pom 文件中看到 Dependency Analyzer標志，說明 Maven Helper 插件就安裝成功了。

圖片

點擊 Dependency Analyzer 之后就會進入到下面的頁面

圖片

從圖中可以看出有哪些jar存在沖突，存在沖突的情況下最終采用了哪個依賴的版本。標紅的就是沖突版本，白色的是當前的解析版本。

如果我們想保留標紅的版本，那我們可以標白區域右擊選擇排除(Exclude)即可。

5、總結

一般我們在解決依賴沖突的時候，都會選擇保留jar高的版本，因為大部分jar在升級的時候都會做到向下兼容，所以只要保留高的版本就不會有什么問題。

但是有些包，版本變化大沒法去做向下兼容，高版本刪了低版本的某些類或者某些方法，那么這個時候就不能一股腦的去選擇高版本，但也不能選擇低版本。

就比如下面這個案例

依賴鏈路一：A -> B -> C -> X(1.0)
依賴鏈路二：F -> D -> X(2.0)

X(2.0) 沒有對 X(1.0) 做向下兼容也就是說可能存在排除哪個都不行，那怎么辦我們只能考慮升級A的版本或者降低F的版本。比如A升級到A(2.0),使它依賴的X版本變成X(2.0)這樣的話就解決依賴沖突。

但話有說回來 A升級到A(2.0) 可能會影響許許多多的地方，比如自己項目中代碼是否需要改變，或者因為 A升級到A(2.0) 導致 B和C的版本有所改變，這些影響點都需要我們去考慮的。所以說為什么說一個大型項目穩定后，Pom文件的升級是件繁瑣的事情，那是因為考慮的東西是在太多了，稍有不慎就會因為依賴沖突而導致系統報錯。