Maven 依赖排查速查 - 常用命令大全

依赖树与来源定位

只看直接依赖（第一层）

mvn dependency:tree -Ddepth=1

过滤指定构件的引入路径

mvn dependency:tree -Dincludes=<groupId>:<artifactId>

显示被仲裁丢弃的版本（排查冲突关键）

mvn dependency:tree -Dverbose

依赖树导出到文件慢慢分析

mvn dependency:tree -DoutputFile=dep-tree.txt

下载依赖源码（看实现用）

mvn dependency:sources

冲突解决

排除传递依赖的 pom 写法

<exclusions> 标签（写在对应 <dependency> 内）

统一版本的 pom 写法（优先于传递仲裁）

<dependencyManagement> 锁定版本

依赖收敛检查（防冲突回归，需 enforcer 插件）

mvn enforcer:enforce -Drules=dependencyConvergence

导出全部依赖 jar 核对实际版本

mvn dependency:copy-dependencies -DoutputDirectory=./libs

更新与本地仓库

查看可更新的依赖版本（需 versions 插件）

mvn versions:display-dependency-updates

查看可更新的插件版本（需 versions 插件）

mvn versions:display-plugin-updates

清除本地仓库指定构件并重下 ⚠️

mvn dependency:purge-local-repository -DmanualInclude=<groupId>:<artifactId>

📖 Maven 依赖排查速查