mvn dependency:tree 报错或输出混乱时，应先用 -X 查看真实失败点，排除 profile 干扰，识别循环依赖（omitted for cycle），确保 exclusion 位置正确且坐标精确匹配，合理使用 dependencyManagement 与 properties 锁定版本，并检查 scope、IDE 缓存及类加载路径。
mvn dependency:tree 报错或输出混乱怎么办
不是所有 mvn dependency:tree 都能直接看出冲突——比如遇到循环依赖、BOM 导入失败、或某些 plugin（如 spring-boot-maven-plugin）干扰时，它可能只报 Could not resolve dependencies 或干脆卡住。
- 先加
-X跑一次：mvn -X dependency:tree -Dverbose -Dincludes=groupId:artifactId，看真实 resolve 失败点在哪一行 - 避免被 parent pom 或 profiles 干扰：临时加
-P!xxx关掉可疑 profile，或用-DskipTests -Dmaven.javadoc.skip=true减少插件副作用 - 如果 tree 输出里出现
omitted for cycle，说明存在 A→B→A 这类循环引用，得手动查pom.xml中的<dependency>和<parent>链路
exclude 排除依赖后依然生效的常见原因
<exclusion> 写对了但没起作用，多数是因为排除位置错了——Maven 只会排除「当前 direct dependency」声明里的传递依赖，不会向上追溯父 POM 或 BOM。
- 检查 exclusion 是写在哪个
<dependency>下的：必须是那个真正引入冲突 jar 的直连依赖，而不是它的上层调用者 - 确认 artifactId 和 groupId 完全匹配（注意大小写和连字符），例如排除 Log4j 2.x 却写了
<artifactId>log4j</artifactId>（少了个-core）就无效 - 如果用了 Spring Boot 的
spring-boot-dependenciesBOM，光 exclude 没用，得配合<properties>锁定版本，否则 BOM 会在 dependencyManagement 里重新拉回旧版
dependencyManagement 和 properties 锁版本的区别与陷阱
很多人以为在 <properties> 里写 slf4j.version=1.7.36 就能锁死，其实它只对使用 ${slf4j.version} 占位符的 dependency 生效；而 <dependencyManagement> 才是真正控制“谁的版本最终被采纳”的地方。
-
<dependencyManagement>中的声明不引入 jar，只提供版本仲裁依据；必须搭配子模块里的无版本<dependency>才触发锁定 - 多个
<dependencyManagement>块（比如 parent + 当前 pom）叠加时，**就近优先**：当前 pom 的 management 会覆盖 parent 的同坐标依赖定义 - BOM（如
spring-boot-dependencies）本质就是个巨型<dependencyManagement>，它默认优先级高于你本地写的 management，除非你把它<scope>import</scope>放在最后
IDE 显示依赖正常但运行时报 NoClassDefFoundError
这是典型“编译期有、运行期丢”的信号，往往因为 Maven 依赖范围（<scope>）或 classpath 构建顺序出问题。
- 检查报错类所属 jar 的
<scope>：如果是provided（如 servlet-api），打包时不会打进 war/jar，但 Tomcat 等容器会提供；若换到非标准环境（如 Spring Boot fat jar），就得改成compile或显式添加 - Spring Boot 项目注意
spring-boot-maven-plugin的<layout>配置：默认JARlayout 会把依赖解压进BOOT-INF/lib/，某些老工具（如 JRebel）或自定义 ClassLoader 可能找不到 - IDE 缓存常滞后：IntelliJ 要点
Maven → Reload project，Eclipse 得右键项目 →Maven → Update Project…并勾选Force Update
最麻烦的情况是同一个类被两个不同版本 jar 同时加载，且 JVM 选择了错误的那个——这时候得用 -verbose:class 启动参数看实际加载路径，再倒推是哪个 dependencyManagement 或 exclusion 没生效。
