快速定位排查maven依赖冲突：mvn dependency:tree

mvn dependency:tree

一、命令核心作用

1. 依赖可视化
   以树形结构展示项目的依赖关系，包括：

   • 直接依赖：pom.xml 中显式声明的依赖
   • 传递依赖：被直接依赖所引入的间接依赖

2. 冲突排查
   快速定位依赖版本冲突（同一个库出现多个版本时显示路径）。

3. 依赖溯源
   跟踪传递依赖的来源（例如：依赖 A 引入了 B）。

二、基础用法

mvn dependency:tree

输出示例：

[INFO] com.example:demo:jar:1.0
[INFO] +- org.springframework:spring-core:jar:5.3.10:compile
[INFO] |  \- commons-logging:commons-logging:jar:1.2:compile
[INFO] \- junit:junit:jar:4.13.2:test
[INFO]    \- org.hamcrest:hamcrest-core:jar:1.3:test

三、进阶参数详解

四、过滤依赖实操

1. 包含指定依赖
   只输出 log4j 相关依赖：

   mvn dependency:tree -Dincludes=log4j:log4j
   

2. 排除依赖
   过滤掉 slf4j：

   mvn dependency:tree -Dexcludes=org.slf4j:*
   

3. 组合过滤
   仅检查 com.google.guava 的 test 作用域依赖：

   mvn dependency:tree -Dincludes=com.google.guava:* -Dscope=test
   

五、解决依赖冲突

1. 查看冲突版本
   使用 -Dverbose 参数显示被忽略的版本：

   mvn dependency:tree -Dverbose
   

   输出示例：

   [INFO] \- org.slf4j:slf4j-log4j12:jar:1.7.30:compile
   [INFO]    +- log4j:log4j:jar:1.2.17:compile
   [INFO]    \- org.slf4j:slf4j-api:jar:1.7.30:compile (版本冲突: 忽略 1.7.25)
   

2. 分析冲突路径
   从树中定位哪个依赖引入了冲突版本，在 pom.xml 中通过 <exclusions> 解决：

   <dependency>
       <groupId>org.example</groupId>
       <artifactId>problematic-lib</artifactId>
       <exclusions>
           <exclusion>
               <groupId>conflict-group</groupId>
               <artifactId>conflict-artifact</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

六、注意事项

1. 依赖解析阶段
   命令会触发 Maven 的依赖解析流程（无需重新编译代码）。

2. 多模块项目
   在根目录执行时默认显示所有子模块依赖树。若需单模块：

   mvn -pl <模块名> dependency:tree
   

3. 图形化工具
   输出为 DOT 格式后可生成可视化图：

   mvn dependency:tree -DoutputType=dot > deps.dot
   dot -Tpng deps.dot -o deps.png  # 需安装 Graphviz
   

七、典型应用场景

• 排查 ClassNotFoundException 或 NoSuchMethodError（依赖冲突）
• 验证新引入的依赖是否生效
• 精简项目依赖（移除无用传递依赖）

掌握此命令能极大提升 Maven 项目依赖问题的解决效率！