快捷導(dǎo)航

IDEA查看Maven依賴樹與解決Jar包沖突的方法

更新時(shí)間：2025年11月10日 10:02:06 作者：Knight_AL

這篇文章主要介紹了如何使用IDEA查看Maven依賴樹,找出沖突的jar包,并提供了解決沖突的方法,包括使用排除（exclusion）和在dependencyManagement中強(qiáng)制指定版本,需要的朋友可以參考下

  <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>6.0.9</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>5.3.23</version>
        </dependency>
    </dependencies>

一、查看依賴樹

方法 1：IDEA 自帶 Maven 工具

打開右側(cè) Maven 工具欄（快捷鍵 Alt+Shift+M / View > Tool Windows > Maven）。

找到你的項(xiàng)目，展開 Dependencies 節(jié)點(diǎn)。

這里能看到所有依賴樹結(jié)構(gòu)。
如果某個(gè)依賴有沖突，IDEA 通常會(huì)用 灰色/紅色字體標(biāo)注出被排除或版本沖突的 jar。

鼠標(biāo)懸停在依賴上，可以看到它的 來源（哪個(gè)依賴引入的）。

方法 2：使用命令行

在項(xiàng)目根目錄執(zhí)行：

mvn dependency:tree

這會(huì)打印依賴樹，例如：

[INFO] org.example:dependency-test:jar:1.0-SNAPSHOT
[INFO] +- org.springframework:spring-webmvc:jar:6.0.9:compile
[INFO] |  +- org.springframework:spring-beans:jar:6.0.9:compile
[INFO] |  +- org.springframework:spring-context:jar:6.0.9:compile
[INFO] |  +- org.springframework:spring-core:jar:6.0.9:compile
[INFO] |  |  \- org.springframework:spring-jcl:jar:6.0.9:compile
[INFO] |  +- org.springframework:spring-expression:jar:6.0.9:compile
[INFO] |  \- org.springframework:spring-web:jar:6.0.9:compile
[INFO] |     \- io.micrometer:micrometer-observation:jar:1.10.7:compile
[INFO] |        \- io.micrometer:micrometer-commons:jar:1.10.7:compile
[INFO] \- org.springframework:spring-aop:jar:5.3.23:compile

org.springframework:spring-beans:jar:6.0.9:compile用的6.0.0的版本

如果樹太大，可以加過濾：

mvn dependency:tree -Dincludes=org.springframework

方法 3：IDEA 插件（推薦）

安裝 Maven Helper 插件（在 IDEA 插件市場(chǎng)搜索）。

打開 pom.xml，底部會(huì)出現(xiàn) Dependency Analyzer 標(biāo)簽頁(yè)。

在這個(gè)面板里，可以：

一鍵查看依賴樹
高亮顯示沖突 jar 包
直接右鍵選擇 Exclude 依賴

二、找出沖突 jar 包

在依賴樹里尋找 同一個(gè) groupId + artifactId 但不同版本的依賴。

例如：

org.springframework:spring-beans:6.0.9
org.springframework:spring-beans:5.3.23 (omitted for conflict)

表示 spring-beans 有兩個(gè)版本沖突。
Maven 默認(rèn)會(huì)選 路徑最短（離項(xiàng)目最近）的依賴，其他版本就會(huì)被排除（omitted）。
但有時(shí)候這個(gè)版本并不是你想要的，就需要手動(dòng)干預(yù)。

三、解決沖突（exclusion）

在 pom.xml 中找到?jīng)_突依賴的 上游依賴，添加 exclusion。

例如，如果 spring-boot-starter 引入了錯(cuò)誤的 commons-logging，可以這樣寫：

       <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>6.0.9</version>
            <exclusions>
                <exclusion>
                    <groupId>org.springframework</groupId>
                    <artifactId>spring-beans</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

或者如果只是版本不一致，可以在 dependencyManagement 里強(qiáng)制指定版本：

<dependencyManagement>
    <dependencies>
        <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-beans</artifactId>
            <version>5.3.23</version>
        </dependency>
    </dependencies>
</dependencyManagement>