如何排查并避免两个Maven依赖引入重复的传递依赖

你可以通过以下几种方式快速识别重复引入的传递依赖，解决mvn dependency:tree原生输出可读性差的问题：

1. 命令行过滤查询指定依赖的引入来源 #

如果要排查特定依赖（比如示例中的junit.jupiter）的所有引入路径，直接给dependency:tree加上过滤参数即可，输出结果会仅保留目标依赖的完整引入链路，无关依赖会全部被过滤：

mvn dependency:tree -Dincludes=org.junit.jupiter:*

如果要查看所有被Maven版本调解掉的重复依赖，可以加上-Dverbose参数，所有存在冲突的依赖会标注omitted for conflict with [版本号]，可直接定位重复引入的来源：

mvn dependency:tree -Dverbose

2. 可视化工具快速排查冲突 #

IDEA等主流IDE可安装Maven Helper插件，安装完成后打开pom.xml文件，切换到底部的「Dependency Analyzer」标签页：

• 选择「Conflicts」视图，所有存在重复引入/版本冲突的依赖会直接展示
• 点击对应依赖可查看所有引入它的上层显式依赖路径
• 右键可一键生成排除规则，自动写入pom.xml的对应依赖配置中，无需手动编写exclusion标签

3. 批量/CI流程集成方案 #

如果需要批量检测全项目的重复依赖，或把检测能力集成到CI流水线中，可以使用以下两个命令：

• 输出排序后的全量依赖列表，相同groupId、artifactId的依赖会相邻排列，可快速识别多版本引入的情况：

  mvn dependency:list -Dsort=true
  

• 直接执行重复依赖分析，命令执行完成后会直接输出所有重复引入的依赖清单：

  mvn dependency:analyze-duplicate
  

冲突处理建议 #

定位到重复引入的传递依赖后，有两种常用的解决方式：

• 对不需要引入该传递依赖的上层显式依赖，添加exclusions标签排除对应的传递依赖
• 在pom.xml的dependencyManagement节点统一定义该传递依赖的版本号，项目内所有引入该依赖的地方都会自动沿用统一版本，无需逐个排除，更适合多模块项目的依赖统一管理

内容的提问来源于stack exchange，提问作者Matt C.