mvn dependency:tree 命令用于查看 maven 项目依赖树，定位冲突、重复及传递依赖；常用参数包括 -dverbose、-dincludes、-dexcludes、-dscope 和 -doutputfile；配合 ide 图形化工具与排除配置可高效解决依赖问题。

在 Maven 项目中，dependency:tree 是一个非常实用的命令，用于查看当前项目的完整依赖树，帮助你识别依赖冲突、重复引入、传递依赖来源等问题。

基础用法：快速查看依赖树

在项目根目录（含 pom.xml 的目录）下运行以下命令：

mvn dependency:tree

这会输出整个项目的依赖树，按层级缩进展示。但默认只显示 compile 范围的依赖，且不显示被排除（excluded）或已忽略的依赖。

常用参数增强可读性与排查能力

实际使用中建议搭配几个关键参数：

• -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></exclusions> 在 pom 中显式排除

例如发现两个不同版本的 slf4j-api，可在引入它的父依赖中添加排除：

  org.slf4j
  slf4j-api

不复杂但容易忽略细节，多用 -Dverbose 和 -Dincludes 就能快速定位绝大多数依赖问题。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南