Maven 依赖调解源码解析（四）：传递依赖，第一声明者优先

本文是系列文章《Maven 源码解析：依赖调解是如何实现的？》第四篇，主要介绍依赖调解的第二条原则：传递依赖，第一声明者优先。请按顺序阅读其他系列文章，系列文章总目录参见：https://www.cnblogs.com/xiaoxi666/p/15583241.html。

场景

路径最近者优先原则不能解决所有问题，比如这样的依赖关系：A－＞ C－＞X（1.0）、A－＞D－＞X（2.0），X（1.0）和 X（2.0）的依赖路径长度是一样的，都为 2。那么到底谁会被解析使用呢？在 Maven 2.0.8 及之前的版本中，这是不确定的，但是从 Maven 2.0.9 开始，为了尽可能避免构建的不确定性，Maven 定义了依赖调解的第二原则：第一声明者优先。在依赖路径长度相等的前提下，在 POM 中依赖声明的顺序决定了谁会被解析使用，顺序最靠前的那个依赖优胜。该例中，C 的依赖声明在 D 之前，那么 X（1.0）就会被解析使用。

B、C 、D 的 pom.xml 内容均不变。A 的 pom.xml 内容改动一下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>mavenDependencyDemo</artifactId>
        <groupId>org.example</groupId>
        <version>1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>A</artifactId>
    <version>1.0</version>

    <dependencies>
        <dependency>
            <groupId>org.example</groupId>
            <artifactId>C</artifactId>
            <version>1.0</version>
        </dependency>

        <dependency>
            <groupId>org.example</groupId>
            <artifactId>D</artifactId>
            <version>1.0</version>
        </dependency>


    </dependencies>

</project>

源码

和前面的分析方法一致，我们先执行 mvn dependency:tree -Dverbose 命令，看看输出：

[INFO] Scanning for projects...
[INFO] 
[INFO] ---------------------------< org.example:A >----------------------------
[INFO] Building A 1.0
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-dependency-plugin:2.8:tree (default-cli) @ A ---
[INFO] org.example:A:jar:1.0
[INFO] +- org.example:C:jar:1.0:compile
[INFO] |  \- org.example:X:jar:1.0:compile
[INFO] \- org.example:D:jar:1.0:compile
[INFO]    \- (org.example:X:jar:2.0:compile - omitted for conflict with 1.0)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.017 s
[INFO] Finished at: 2021-11-20T15:52:36+08:00
[INFO] ------------------------------------------------------------------------

可以看出，A 依赖了 X（1.0），而 X（2.0）被忽略了。关键语句变成了

(org.example:X:jar:2.0:compile - omitted for conflict with 1.0)

看起来还是 omitted for conflict with 这个信息。基于前面的分析，很可能进入了这段代码：

那自然而然，resolved 就是 X（1.0），我们直接进入源码分析：

很明显看出，如果两个依赖的路径深度相同，保留最先声明的依赖。

小结

有了前面的分析经验，这个原则的分析就很简单了，仍然是 NewestConflictResolver 进行调解。
这个「小于等于」就很有灵性，同时实现了传递依赖的路径最近者优先和第一声明者优先这两个原则。