前言

依賴(lài)沖突是寫(xiě) Java 項(xiàng)目時(shí)最常見(jiàn)、也最煩的坑之一。特別是在大型項(xiàng)目、Spring Boot、多模塊工程里，一旦依賴(lài)多了，沖突基本是逃不掉的。

最典型的現(xiàn)象包括：

• 項(xiàng)目能編譯但運(yùn)行時(shí)報(bào)錯(cuò)
• 某些類(lèi)或方法突然消失：NoSuchMethodError、ClassNotFoundException
• 構(gòu)建成功但 Web 服務(wù)啟動(dòng)直接掛掉
• 明明寫(xiě)的代碼沒(méi)問(wèn)題，就是某個(gè)庫(kù)版本抽風(fēng)

這篇文章會(huì)帶你用最實(shí)用、最開(kāi)發(fā)者視角的方法來(lái)解決 Maven 依賴(lài)沖突，包括排查、分析、修復(fù)三個(gè)步驟，另外還會(huì)給一個(gè)可運(yùn)行 Demo，讓你能自己復(fù)現(xiàn)整個(gè)過(guò)程。

摘要

Maven 依賴(lài)沖突產(chǎn)生的原因通常是多個(gè)庫(kù)依賴(lài)了同一個(gè)組件的不同版本，最終 Maven 只會(huì)選擇其中一個(gè)版本打包，但這個(gè)版本可能不是你預(yù)期的，從而導(dǎo)致運(yùn)行時(shí)異常。
解決依賴(lài)沖突的通用流程是：

• 用 mvn dependency:tree 查依賴(lài)樹(shù)
• 用 <dependencyManagement> 鎖死統(tǒng)一版本
• 用 exclude 精準(zhǔn)剔除不需要的依賴(lài)

掌握這個(gè)流程，你就能成為團(tuán)隊(duì)里“專(zhuān)業(yè)滅火 Maven 依賴(lài)沖突”的那個(gè)人。

描述（應(yīng)用場(chǎng)景 + 沖突成因分析）

真實(shí)開(kāi)發(fā)里依賴(lài)沖突出現(xiàn)得非常頻繁，比如：

• Spring Boot + 某個(gè)第三方 SDK，各自帶一個(gè)不同版本的 Jackson
• MySQL 驅(qū)動(dòng)版本沖突導(dǎo)致連接池啟動(dòng)失敗
• 舊系統(tǒng)依賴(lài) log4j 1.x，新系統(tǒng)依賴(lài) log4j 2.x，結(jié)果日志全不能用
• 你依賴(lài)了多個(gè) Apache 組件，結(jié)果版本互相不兼容

為什么 Maven 會(huì)產(chǎn)生沖突？因?yàn)?Maven 的依賴(lài)解析有兩個(gè)關(guān)鍵機(jī)制：

• 最近路徑（nearest-wins）:Maven 會(huì)選擇依賴(lài)樹(shù)中路徑最短的那個(gè)版本，而不一定是你的 <dependency> 里寫(xiě)的那個(gè)。
• 只保留一個(gè)版本:最終打包進(jìn)去的依賴(lài)只有一個(gè)版本，它還可能是你不想要的那個(gè)。

這就是為什么一個(gè)常見(jiàn)場(chǎng)景中，明明你引入的是新版本庫(kù)，但運(yùn)行時(shí)用的卻是舊版本。

題解答案（Maven 依賴(lài)沖突的標(biāo)準(zhǔn)解決方案）

要解決依賴(lài)沖突，推薦遵循下面這個(gè)“三板斧”流程：

• 使用 mvn dependency:tree 查清楚到底誰(shuí)依賴(lài)了哪個(gè)版本
• 使用 <dependencyManagement> 統(tǒng)一全局依賴(lài)版本
• 使用 exclude 精準(zhǔn)剔除特定依賴(lài)

把這個(gè)流程跑通，99% 的依賴(lài)沖突都能解決。

題解代碼分析（可運(yùn)行 Demo）

下面我們通過(guò)一個(gè)簡(jiǎn)單的 Maven 項(xiàng)目來(lái)演示一下依賴(lài)沖突是怎么發(fā)生的，以及怎么一步一步解決。

1. 構(gòu)建一個(gè)可復(fù)現(xiàn)的沖突案例

我們用 Spring Boot，并故意加入一個(gè)舊版本 Jackson。

pom.xml：

<dependencies>
    <!-- Spring Boot 自帶 jackson 2.15+ -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- 故意加入一個(gè)舊版本的 jackson，會(huì)導(dǎo)致沖突 -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.9.0</version>
    </dependency>
</dependencies>

啟動(dòng)項(xiàng)目：

mvn spring-boot:run

很可能報(bào)錯(cuò)：

NoSuchMethodError: com.fasterxml.jackson.databind.ObjectMapper.findModules()

為什么？因?yàn)?Spring Boot 需要 Jackson 2.15，但你強(qiáng)行塞了個(gè) 2.9，API 完全不兼容。

2. 用 dependency:tree 分析依賴(lài)樹(shù)（最關(guān)鍵的一步）

執(zhí)行：

mvn dependency:tree -Dincludes=com.fasterxml.jackson

輸出類(lèi)似：

+- org.springframework.boot:spring-boot-starter-web
|  \- com.fasterxml.jackson.core:jackson-databind:2.15.2
\- com.fasterxml.jackson.core:jackson-databind:2.9.0

這告訴我們：

• 依賴(lài)樹(shù)里同時(shí)存在 **2.15.2** 和 **2.9.0**
• 最終 Maven 用的是更靠近根節(jié)點(diǎn)的版本（可能是 2.9.0）

這是典型的依賴(lài)沖突。

3. 使用 dependencyManagement 鎖定版本（最佳實(shí)踐）

我們希望所有模塊都用 Jackson 2.15，因此可以這樣寫(xiě)：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.15.2</version>
        </dependency>
    </dependencies>
</dependencyManagement>

然后去掉本地手寫(xiě)的版本號(hào)：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
</dependency>

再次運(yùn)行：

mvn spring-boot:run

服務(wù)成功啟動(dòng)。

4. 使用 exclude 精準(zhǔn)排除沖突依賴(lài)（可選但很常用）

假設(shè)你依賴(lài)了某個(gè) SDK，它內(nèi)部自帶 Jackson 2.6，這時(shí)候你可以這樣排除掉：

<dependency>
    <groupId>com.xxx</groupId>
    <artifactId>xxx-sdk</artifactId>
    <version>1.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
    </exclusions>
</dependency>

然后整個(gè)項(xiàng)目就只會(huì)用一套 Jackson 版本了。

示例測(cè)試及結(jié)果

可以看到，通過(guò)“三板斧”處理后，依賴(lài)沖突被徹底解決。

時(shí)間復(fù)雜度

依賴(lài)解析的核心開(kāi)銷(xiāo)是 Maven 構(gòu)建依賴(lài)樹(shù)的過(guò)程，復(fù)雜度大約為：

O(N) ~ O(N log N)

對(duì)一般項(xiàng)目來(lái)說(shuō)非常小，對(duì)性能影響幾乎可以忽略不計(jì)。

空間復(fù)雜度

依賴(lài)樹(shù)通常大小約等于依賴(lài)數(shù)量：

O(N)

也在可控范圍內(nèi)。

總結(jié)

Maven 依賴(lài)沖突看起來(lái)復(fù)雜，其實(shí)本質(zhì)很簡(jiǎn)單：依賴(lài)樹(shù)里存在多個(gè)同名不同版本的 jar，運(yùn)行時(shí)必須選一個(gè)，但這個(gè)版本可能跟你代碼不兼容。

解決沖突的核心思路是：

• 查：mvn dependency:tree 找出沖突源頭
• 定：用 <dependencyManagement> 統(tǒng)一所有版本
• 剔：用 <exclusions> 清掉你不想要的依賴(lài)

只要掌握這套方法，你就能解決絕大多數(shù)依賴(lài)沖突問(wèn)題。

到此這篇關(guān)于Maven中依賴(lài)沖突的排查和修復(fù)全流程指南的文章就介紹到這了,更多相關(guān)Maven依賴(lài)沖突內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！