第 3 章 依赖战争：传递、冲突与版本仲裁
文档摘要
第 3 章 依赖战争：传递、冲突与版本仲裁 本章要回答的三个问题： 明明只声明了 5 个依赖，为什么依赖树膨胀到 200 多行？传递依赖按什么规则蔓延？ 同一构件的多个版本同时入场时，Maven 按什么规则裁决？NoSuchMethodError 这类运行期爆炸如何在构建期定位？ 团队级版本混乱如何治理？dependencyManagement 与 BOM 这套"中央指挥部"怎么建制？ 为什么会有这一章 第 1 章开篇那场凌晨事故——生产环境 NoSuchMethodError——的完整战例将在本章复盘。依赖战争是 Maven 世界伤亡最重的战场：构建能过、测试能过、上线就炸；本机好好的、CI 就挂；升一个库、塌一大片。
第 3 章 依赖战争：传递、冲突与版本仲裁
本章要回答的三个问题：
- 明明只声明了 5 个依赖，为什么依赖树膨胀到 200 多行？传递依赖按什么规则蔓延？
- 同一构件的多个版本同时入场时，Maven 按什么规则裁决？NoSuchMethodError 这类运行期爆炸如何在构建期定位？
- 团队级版本混乱如何治理？dependencyManagement 与 BOM 这套"中央指挥部"怎么建制？
为什么会有这一章
第 1 章开篇那场凌晨事故——生产环境 NoSuchMethodError——的完整战例将在本章复盘。依赖战争是 Maven 世界伤亡最重的战场：构建能过、测试能过、上线就炸；本机好好的、CI 就挂；升一个库、塌一大片。它的根源不是 Maven 有缺陷，而是传递依赖机制与人的直觉之间有一条认知鸿沟：你以为你引入的是 5 个库，实际入场的是它们的全部社会关系。
本章按战争进程推进：先看传递依赖怎么蔓延（3.1），再学冲突定位战术（3.2），然后建立版本仲裁制度（3.3），最后补上补给线故障处置（3.4）、供应链防线（3.5）与排查方法论（3.6）。这一章值得占掉你一半的学习时间。
读完能解决什么
- 独立完成一次依赖冲突的"现象到根因"定位，输出修复方案与影响评估；
- 说清最近优先与先声明优先两条调解规则的适用边界，解释 omitted 日志的每一行；
- 用 dependencyManagement、BOM 导入与 enforcer 规则为团队搭建版本仲裁体系；
- 处置下载失败类补给故障，识别供应链投毒的主要攻击面；
- 按"分类、取证、假设、验证"四步法组织一次系统化排查。
本章知识点清单
- 理解传递依赖的引入规则：scope 与 optional 对向下传递的拦截作用；
- 掌握依赖调解两原则：路径最短优先、路径等长时先声明优先；
- 掌握 dependency:tree -Dverbose 与 -Dincludes 的组合用法，能读出每个落选版本；
- 掌握 exclusion 的精确打法与"广撒网式排除"的危害；
- 理解 dependencyManagement 只裁版本不引依赖的语义，与 dependencies 的本质区别；
- 掌握 BOM 的 scope import 导入方式与多 BOM 共存时的顺序规则；
- 掌握 enforcer 的 dependencyConvergence 与 requireUpperBoundDeps 两条内置规则；
- 理解依赖混淆、抢注与投毒三类供应链攻击的入口与防线。
图：依赖战争地形图
各节怎么分工
| 节号 | 回答哪个问题 | 关键产出 |
|---|---|---|
| 3.1 传递依赖的蔓延路径 | 战争为何总在扩大 | 传递规则表与树膨胀案例 |
| 3.2 依赖冲突战场定位 | 冲突怎么找怎么修 | 定位流程图与修复决策表 |
| 3.3 版本仲裁中央指挥部 | 版本裁决权归谁 | BOM 建制方案与 enforcer 门禁 |
| 3.4 依赖下载失败断粮处置 | 补给断了怎么办 | 分场景处置手册 |
| 3.5 供应链安全防线 | 弹药会不会有毒 | 攻击面清单与审计工具链 |
| 3.6 系统化排查战术 | 打不赢时怎么组织 | 四步排查法与作战记录制度 |
先决条件
- 已读第 1 章并能熟练使用 dependency:tree 与 effective-pom 两件勘查仪器；
- 理解 scope 的基本概念（compile、test、provided 等第 3.1 节会展开传递维度）；
- 手边最好有一个能联网的 Maven 环境，本章案例均可在空项目复现。
三条作战纪律预告
本章反复出现三条纪律，先立在这：取证先于动手（三份快照制度，3.6 节）、修复先问影响面（冲突修好只是起点，反向影响要评估，3.2 节）、制度先于反应（enforcer 门禁挡住下一次，3.3 节）。带着这三条读案例，每节的战术都会自然归位。
往下走到哪
本章打完，单项目层面的依赖问题你已能独立处置。第 4 章把战争经验制度化：多模块工程里仲裁权如何逐级下放、私服如何成为全团队的统一补给线。