在 Maven 中，传递性依赖（Transitive Dependency）是一个核心特性，它使得我们在引入依赖时，不仅可以直接使用我们声明的依赖，还可以自动加载被这些依赖所依赖的其他库。

这种功能大大减少了开发人员手动管理依赖的工作量，但也会引入一些复杂性，比如版本冲突等问题。

什么是传递性依赖？

• 定义：如果项目 A 依赖项目 B，而项目 B 又依赖于项目 C，那么通过 Maven 的依赖传递特性，项目 A 可以直接使用项目 C，而无需显式声明对项目 C 的依赖。
• 作用：它简化了依赖的管理，避免开发者需要显式地添加每一层所需的库。

假设一个项目 A 的 pom.xml 中有如下依赖：

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

而库 B 的 pom.xml 中包含以下依赖：

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

那么，Maven 会自动将 C 加载到项目 A 的依赖中，而无需我们手动声明它。

---

原理说明

Maven 的依赖传递是基于 依赖树 的计算和解析机制：

1. 直接依赖声明：当项目声明了直接依赖（如项目 A 依赖 B），Maven 会读取直接依赖的 pom.xml 文件。
2. 递归解析子依赖：在读取直系依赖 B 的同时，Maven 会解析 B 所依赖的子依赖（如 C、D 等）。
3. 依赖版本冲突处理：

• Maven 会分析整个依赖树中的依赖版本，并使用最近路径优先原则（也叫路径优先原则）。即优先选择距离当前项目依赖声明最近的版本。
• 如果不同版本处于相同的层级（没有路径优先性），则默认选择最先解析的依赖。

依赖树讲解篇

假设项目 A 定义依赖如下：

• A -> B (Version 1.0)
• A -> D (Version 2.0)

而 B 定义依赖：

• B -> C (Version 1.0)
• B -> D (Version 1.5)

构建依赖树如下：

A
├── B (1.0)
│   ├── C (1.0)
│   └── D (1.5)
└── D (2.0)

最终 Maven 会选择的依赖版本为：

• B -> 1.0 （直接依赖，指定版本）
• C -> 1.0 （直接由 B 传递而来）
• D -> 2.0 （路径优先，A 直接依赖的版本比 B 传递的版本更新）

Maven 提供类似 mvn dependency:tree 命令，可以帮助你清晰地查看项目的依赖树。

---

如何避免

1. 版本冲突处理：

   • 依赖传递过程中，不同库可能引入同一依赖的不同版本
   • 最佳实践：使用 <dependencyManagement> 统一声明关键依赖版本，建立版本控制中心

2. 依赖范围(Scope)影响：

   compile: 默认范围，完全传递
   runtime: 运行时有效，编译时不传递
   provided: 不传递，由运行环境提供
   test: 测试专用，不传递

3. 依赖排除技巧：

   <dependency>
       <groupId>org.example</groupId>
       <artifactId>B</artifactId>
       <version>1.0</version>
       <exclusions>
           <exclusion>
               <groupId>org.example</groupId>
               <artifactId>C</artifactId>
           </exclusion>
       </exclusions>
   </dependency>

4. 依赖树优化：

   • 定期使用 mvn dependency:tree 分析依赖结构
   • 消除无用依赖，减少依赖层级，降低安全风险和构建复杂性

---