mvn dependency:tree 命令用于查看 Maven 项目依赖树，定位冲突、重复及传递依赖；常用参数包括 -Dverbose、-Dincludes、-Dexcludes、-Dscope 和 -DoutputFile；配合 IDE 图形化工具与排除配置可高效解决依赖问题。
在 Maven 项目中，dependency:tree 是一个非常实用的命令，用于查看当前项目的完整依赖树，帮助你识别依赖冲突、重复引入、传递依赖来源等问题。
基础用法：快速查看依赖树
在项目根目录（含 pom.xml 的目录）下运行以下命令：
mvn dependency:tree
这会输出整个项目的依赖树，按层级缩进展示。但默认只显示 compile 范围的依赖，且不显示被排除（excluded）或已忽略的依赖。
立即学习“Java免费学习笔记（深入）”；
常用参数增强可读性与排查能力
实际使用中建议搭配几个关键参数：
-
-Dverbose：显示被忽略（ignored）的依赖（例如因版本冲突被仲裁掉的），便于定位冲突根源 -
-Dincludes=groupId:artifactId：只显示匹配指定坐标（如org.springframework:spring-core）的依赖路径，缩小排查范围 -
-Dexcludes=groupId:artifactId：排除某些干扰项（如测试相关依赖），让输出更聚焦 -
-Dscope=runtime：限定只分析特定作用域（如 runtime、test）的依赖 -
-DoutputFile=tree.txt：将结果导出为文件，方便搜索或分享（支持 .txt 或 .dot 格式）
例如，排查 Jackson 版本冲突时可执行：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
mvn dependency:tree -Dverbose -Dincludes=com.fasterxml.jackson.core:jackson-databind
结合 IDE 和插件提升效率
命令行输出信息量大，容易滚动丢失。推荐配合以下方式：
- IDEA 自带 Maven 工具窗口 → 右键项目 → “Show Dependencies”，图形化展示依赖关系，支持点击跳转和排除操作
- 安装插件 maven-dependency-plugin（通常已内置），确保使用的是较新版本（如 3.3.0+），避免旧版对 Java 17+ 支持不全
- 若遇到“无法解析依赖”错误，先执行
mvn clean compile确保本地仓库完整，再运行 tree 命令
识别并解决典型依赖问题
从 dependency:tree 输出中重点关注三类线索：
-
带
omitted for conflict with X.X.X的行：说明该依赖被 Maven 版本仲裁机制丢弃，X.X.X 是最终选用的版本 - 同一 artifact 出现在多条路径中且版本不同：可能引发 NoClassDefFoundError 或 MethodNotFound 异常
-
意外引入的 transitive 依赖（如 logging 框架、JSON 库）：可通过
<exclusions>在 pom 中显式排除
例如发现两个不同版本的 slf4j-api，可在引入它的父依赖中添加排除：
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
</exclusion>
不复杂但容易忽略细节，多用 -Dverbose 和 -Dincludes 就能快速定位绝大多数依赖问题。
