IDEA 高手必备:一招定位并解决 Maven 依赖冲突
2026/5/12 20:55:12 网站建设 项目流程


来自:https://blog.csdn.net/qq_46548855

推荐一个程序员编程资料站:

http://cxyroad.com

副业赚钱专栏:https://xbt100.top

2024年IDEA最新激活方法

后台回复:激活码

CSDN免登录复制代码插件下载:

CSDN复制插件

以下是正文。


目录

  • 一、查看依赖树

    • 方法 1:IDEA 自带 Maven 工具

    • 方法 2:使用命令行

    • 方法 3:IDEA 插件(推荐)

  • 二、找出冲突 jar 包

  • 三、解决冲突(exclusion)

  • 四、总结


模拟依赖冲突
<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 工具
  • 打开右侧 Maven 工具栏(快捷键Alt+Shift+M / View>Tool Windows>Maven)。

  • 找到你的项目,展开Dependencies节点。

    • 这里能看到所有依赖树结构。

    • 如果某个依赖有冲突,IDEA 通常会用 灰色/红色字体标注出被排除或版本冲突的 jar。

  • 鼠标悬停在依赖上,可以看到它的 来源(哪个依赖引入的)。

方法 2:使用命令行

在项目根目录执行:

mvn dependency:tree

这会打印依赖树,例如:

[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 插件市场搜索)。

  • 打开 pom.xml,底部会出现Dependency Analyzer标签页。

  • 在这个面板里,可以:

    • 一键查看依赖树

    • 高亮显示冲突 jar 包

    • 直接右键选择 Exclude 依赖

二、找出冲突 jar 包

1.在依赖树里寻找 同一个groupId + artifactId但不同版本的依赖。

例如:

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

表示spring-beans有两个版本冲突。

2.Maven 默认会选 路径最短(离项目最近)的依赖,其他版本就会被排除(omitted)。

但有时候这个版本并不是你想要的,就需要手动干预。

三、解决冲突(exclusion)

在 pom.xml 中找到冲突依赖的 上游依赖,添加exclusion

例如,如果spring-boot-starter引入了错误的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里强制指定版本:

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

四、总结

  • 快速看依赖树→ IDEA 自带依赖树 或mvn dependency:tree

  • 高效排查冲突→ 装Maven Helper插件,直观显示冲突。

  • 解决冲突→ 用exclusion排除不需要的包,或在dependencyManagement锁定版本。

<END>

推荐阅读:

副业赚钱推荐:让你的时间开始变现!

免费体验AI图片生成,就在 Image Generator Hub!

程序员在线工具站:cxytools.com 推荐一个自己写的工具站:https://cxytools.com,专为程序员设计,包括时间日期、 JSON处理、SQL格式化、随机字符串生成、UUID生成、文本Hash...等功能,提升开发效 率。 ⬇戳阅读原文直达! 朕已阅

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询