构建与依赖 / 系统课时
导入 BOM 管理依赖版本
导入 BOM 管理依赖版本
当多个模块都依赖同一套组件时,逐个写版本号很容易出现漂移。Maven 可以在 dependencyManagement 中以 import 作用域导入 BOM,让 BOM 统一提供依赖版本,而业务模块只声明自己真正需要的依赖坐标。
学习目标
- 正确使用
type=pom和scope=import导入 BOM - 在业务依赖中省略已经由 BOM 管理的版本号
- 使用依赖树确认最终解析到的实际版本
BOM 只管理版本,不会自动加入依赖
BOM 本质上是一个 packaging=pom 的 Maven POM,其中通常通过 dependencyManagement 维护一组兼容版本。消费方导入 BOM 后,这些管理信息进入当前项目的依赖管理模型,但并不会自动把 BOM 中列出的库加入项目。
例如项目要统一使用 JUnit 5.10.2,可以在 dependencyManagement 中导入官方 junit-bom:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.junit</groupId>
<artifactId>junit-bom</artifactId>
<version>5.10.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>这里的 type 必须是 pom,scope 必须是 import,并且导入项应放在 dependencyManagement 中。不能把 import 当作普通依赖的运行时作用域使用。
业务依赖省略已管理版本
导入 BOM 后,真正需要使用的依赖仍然写在 <dependencies> 中,只是不再重复声明 BOM 已管理的版本。例如完整的最小项目可以写成:
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>bom-demo</artifactId>
<version>1.0.0</version>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.junit</groupId>
<artifactId>junit-bom</artifactId>
<version>5.10.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
</project>junit-jupiter-api 没有 <version>,但 Maven 能从导入的 BOM 中取得 5.10.2。如果删除 BOM,又没有在依赖上补版本,Maven 会在模型构建阶段报告该依赖缺少版本。
用 dependency:tree 检查最终版本
保存上述 POM 后,在项目目录执行依赖树命令,只过滤当前要检查的 JUnit API:
mvn dependency:tree -Dincludes=org.junit.jupiter:junit-jupiter-api预期输出中的关键行应包含:
[INFO] com.example:bom-demo:jar:1.0.0
[INFO] \- org.junit.jupiter:junit-jupiter-api:jar:5.10.2:test
[INFO] BUILD SUCCESS插件版本、下载日志和耗时会因本机环境不同而变化,但依赖树中的 junit-jupiter-api 版本应为 5.10.2。如果显示其他版本,应继续检查当前 POM、父 POM 或其他导入 BOM 是否存在覆盖。
需要改版本时在管理层覆盖
团队通常希望业务依赖继续省略版本,因此临时覆盖 BOM 中某个组件时,优先在当前项目的 dependencyManagement 中显式声明,而不是把版本散落回业务 <dependencies>。
例如仍导入 JUnit BOM,但单独把 API 管理为另一个明确版本,可以增加直接管理项:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<version>5.10.3</version>
</dependency>
<dependency>
<groupId>org.junit</groupId>
<artifactId>junit-bom</artifactId>
<version>5.10.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>这样业务依赖仍然不写版本,但最终模型会采用当前项目直接管理的 5.10.3。实际项目做这种覆盖前,应确认组件之间是否仍兼容;BOM 的价值正是提供经过配套设计的一组版本,随意拆开可能重新引入组合风险。
多个 BOM 同时存在时先验证有效模型
大型项目可能同时导入框架 BOM、测试 BOM 和公司内部 BOM。若它们管理了相同的 groupId 与 artifactId,不要只根据文件位置猜最终版本;应通过 dependency:tree 检查实际依赖,必要时再生成 Effective POM 查看最终的 dependencyManagement。
mvn help:effective-pom -Doutput=effective-pom.xml预期结果:
[INFO] BUILD SUCCESS命令成功后,项目目录会生成 effective-pom.xml。在其中搜索目标 artifactId,可以核对继承、BOM 导入和当前 POM 覆盖完成后的最终管理结果。这个文件用于诊断,不应作为项目源 POM 提交并维护。