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 进行调解。

这个「小于等于」就很有灵性。同时实现了两个原则。