Maven依赖树compile范围无输出但类可编译？依赖作用域解析疑问

问题背景 #

我有一个Maven项目，其中jakarta.enterprise:jakarta.enterprise.cdi-api:4.0.1可在生产源代码中正常使用（编译无问题，@ApplicationScoped注解生效），但执行命令：

mvn dependency:tree -Dscope=compile -Dincludes=jakarta.enterprise:jakarta.enterprise.cdi-api

返回空输出。

不添加作用域过滤器执行时能看到该构件，但最优依赖路径来自一个test作用域的依赖：

+- io.quarkus:quarkus-junit5:jar:3.8.6.1:test
|  \- io.quarkus:quarkus-core:jar:3.8.6.1:compile
|     \- jakarta.enterprise:jakarta.enterprise.cdi-api:jar:4.0.1:compile  ← WINNER

而所有compile作用域的路径（添加-Dverbose参数执行时）显示该构件为omitted for duplicate：

+- io.quarkus:quarkus-arc:jar:3.8.6.1:compile
|  \- (jakarta.enterprise:jakarta.enterprise.cdi-api:jar:4.0.1:compile - omitted for duplicate)

移除quarkus-arc（compile作用域）会导致编译失败，说明实际提供该依赖的是compile作用域路径，而非在最近优先解析中胜出的test路径。

Maven版本： 3.9.15

核心问题 #

1. 若该构件确实在编译类路径上，为何-Dscope=compile会返回空输出？
2. dependency:tree的作用域过滤对存在混合作用域链的传递依赖是否不可靠？
3. 如何通过可靠命令判断传递依赖是否真的在编译类路径上，以及其来源路径？

问题解答 #

1. 空输出的原因 #

dependency:tree的-Dscope=compile过滤逻辑是检查依赖路径的顶层作用域，而非最终依赖的作用域。虽然目标依赖的作用域是compile，但它的最优解析路径顶层是test作用域的quarkus-junit5，这条路径会被scope=compile过滤掉。而compile作用域的路径因为被标记为重复依赖（omitted for duplicate），默认不会被输出，所以最终返回空。

2. 作用域过滤的可靠性 #

是的，存在混合作用域链时，dependency:tree的作用域过滤容易出现误导。它的过滤逻辑基于路径的起始依赖作用域，而非最终依赖实际生效的作用域。如果一个compile作用域的依赖被test路径的同构件先解析命中，就会出现明明依赖在编译类路径，但filter后看不到的情况。

3. 可靠的排查命令 #

（1）确认依赖是否在编译类路径

使用dependency:list命令，指定compile作用域并精确匹配：

mvn dependency:list -Dscope=compile -Dincludes=jakarta.enterprise:jakarta.enterprise.cdi-api

这个命令会直接列出当前作用域下实际生效的依赖，不受路径过滤或重复标记影响。

（2）追踪真实来源路径

结合-Dverbose和-Dscope=compile，同时保留重复依赖的输出：

mvn dependency:tree -Dscope=compile -Dincludes=jakarta.enterprise:jakarta.enterprise.cdi-api -Dverbose

输出中所有包含该依赖的compile路径都会被列出，即使被标记为omitted for duplicate，你能从中找到实际提供编译依赖的路径（比如quarkus-arc那条）。

另外，也可以直接查看编译类路径的详细构成：

mvn dependency:build-classpath -Dmdep.outputFile=compile-classpath.txt

打开文件后搜索目标依赖，再反向查找对应的Jar包来源，结合dependency:tree的verbose输出就能定位真实路径。

内容的提问来源于stack exchange，提问作者Josip Domazet