Maven依賴沖突原因以及解決方法
什么是依賴沖突
依賴沖突是指項(xiàng)目依賴的某一個(gè) jar 包,有多個(gè)不同的版本,因而造成類包版本沖突
依賴沖突的原因
依賴沖突很經(jīng)常是類包之間的間接依賴引起的。每個(gè)顯式聲明的類包都會(huì)依賴于一些其它的隱式類包,這些隱式的類包會(huì)被 maven 間接引入進(jìn)來,從而造成類包沖突
如何解決依賴沖突
首先查看產(chǎn)生依賴沖突的類 jar,其次找出我們不想要的依賴類 jar,手工將其排除在外就可以了。具體執(zhí)行步驟如下
1、查看依賴沖突
a、通過 dependency:tree 是命令來檢查版本沖突
mvn -Dverbose dependency:tree
當(dāng)敲入上述命令時(shí),控制臺(tái)會(huì)出現(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 包不會(huì)被引入。比如上面有一行最后寫著 omitted for conflict with 5.2.7.RELEASE,表示 spring-core 5.2.0 版本不會(huì)被項(xiàng)目引用,而 spring-core 5.2.7 版本會(huì)被項(xiàng)目引用
b、如果是 idea,可以安裝 maven helper 插件來檢查依賴沖突
maven helper 插件安裝成功,點(diǎn)開 pom.xml 會(huì)發(fā)現(xiàn)多了一個(gè) Dependency Analyzer 視圖,如下

上面按鈕的圖標(biāo)含義如下
- Conflicts(查看沖突)
- All Dependencies as List(列表形式查看所有依賴)
- All Dependencies as Tree(樹形式查看所有依賴)
上圖說明有 3 個(gè) jar 存在沖突,點(diǎn)擊沖突的 jar,可以查看和哪個(gè) jar 產(chǎn)生沖突,如下圖

2、解決沖突
項(xiàng)目的 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>
通過查看依賴樹,我們知道項(xiàng)目會(huì)引用 5.2.7.RELEASE 的 spring core jar 包,而不會(huì)引用 5.2.0 的 jar 包,如果我們想用 5.2.0 版本的 spring core 包,我們該如何做?
a、使用第一聲明者優(yōu)先原則
誰先定義的就用誰的傳遞依賴,即在 pom.xml 文件自上而下,先聲明的 jar 坐標(biāo),就先引用該 jar 的傳遞依賴。因此我們?nèi)绻褂?5.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)
通過依賴樹,我們可以看到項(xiàng)目已經(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>

通過上圖可以看到項(xiàng)目引入是 spring core 5.2.0 的包
c、排除依賴
排除依賴如果是 idea,可以使用 maven helper 插件進(jìn)行排除。點(diǎn)開 pom.xml,切換到 Dependency Analyzer 視圖,選擇 All Dependencies as Tree,點(diǎn)擊要排除的 jar,右鍵會(huì)出現(xiàn) Execlude 選項(xiàng),如下

它產(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>

通過上圖可以看到項(xiàng)目引入是 spring core 5.2.0 的包
4、版本鎖定
使用 dependencyManagement 進(jìn)行版本鎖定,dependencyManagement 可以統(tǒng)一管理項(xiàng)目的版本號(hào),確保應(yīng)用的各個(gè)項(xiàng)目的依賴和版本一致。
如果我們項(xià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>
通過上圖可以看到項(xiàng)目引入是 spring core 5.2.0 的包
總結(jié)
綜上就是 maven 如何排查依賴沖突以及解決方法,對于排查依賴個(gè)人比較推薦使用 maven helper 插件,至于解決依賴沖突個(gè)人推薦使用版本鎖定的方法,此外 dependencyManagement 只是聲明依賴,并不自動(dòng)實(shí)現(xiàn)引入,因此子項(xiàng)目需要顯示的聲明需要用的依賴
以上就是Maven依賴沖突原因以及解決方法的詳細(xì)內(nèi)容,更多關(guān)于Maven依賴沖突的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
詳解RabbitMQ中死信隊(duì)列和延遲隊(duì)列的使用詳解
這篇文章主要為大家介紹了RabbitMQ中死信隊(duì)列和延遲隊(duì)列的原理與使用,這也是Java后端面試中常見的問題,感興趣的小伙伴可以了解一下2022-05-05
對SpringBoot項(xiàng)目配置文件進(jìn)行加密實(shí)現(xiàn)過程
文章介紹了如何在Spring Boot項(xiàng)目中使用Maven依賴和單元測試生成加密數(shù)據(jù),并將加密數(shù)據(jù)配置在`bootstrap.yml`或`application.yml`中,同時(shí),分享了如何在不同環(huán)境中配置加密鹽,包括IDE啟動(dòng)項(xiàng)、配置文件和Dockerfile2025-10-10
JDK數(shù)組阻塞隊(duì)列源碼深入分析總結(jié)
在這篇文章當(dāng)中,我們將通過源碼仔細(xì)為大家介紹一下JDK具體是如何實(shí)現(xiàn)數(shù)組阻塞隊(duì)列的,文中的示例代碼講解詳細(xì),感興趣的可以了解一下2022-08-08
java打包maven啟動(dòng)報(bào)錯(cuò)jar中沒有主清單屬性
本文主要介紹了java打包maven啟動(dòng)報(bào)錯(cuò)jar中沒有主清單屬性,可能原因是創(chuàng)建springboot項(xiàng)目時(shí),自動(dòng)導(dǎo)入,下面就來介紹一下解決方法,感興趣的可以了解一下2024-03-03
springboot集成Deepseek4j的項(xiàng)目實(shí)踐
本文主要介紹了springboot集成Deepseek4j的項(xiàng)目實(shí)踐,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2025-03-03
SpringBoot3整合SpringDoc OpenAPI生成接口文檔的詳細(xì)過程
SpringDoc OpenAPI 是一個(gè)強(qiáng)大的工具,能夠幫助我們輕松生成 OpenAPI 3.0 規(guī)范的文檔,并提供交互式的 Swagger UI 界面,所以本文給大家介紹了SpringBoot3整合SpringDoc OpenAPI生成接口文檔的詳細(xì)過程,需要的朋友可以參考下2024-07-07
java編程SpringSecurity入門原理及應(yīng)用簡介
Spring 是非常流行和成功的 Java 應(yīng)用開發(fā)框架,Spring Security 正是 Spring 家族中的成員。Spring Security 基于 Spring 框架,提供了一套 Web 應(yīng)用安全性的完整解決方案2021-09-09

