构建与依赖 / 系统课时

导入 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:

xml
<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 已管理的版本。例如完整的最小项目可以写成:

xml
<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:

bash
mvn dependency:tree -Dincludes=org.junit.jupiter:junit-jupiter-api

预期输出中的关键行应包含:

text
[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 管理为另一个明确版本,可以增加直接管理项:

xml
<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。

bash
mvn help:effective-pom -Doutput=effective-pom.xml

预期结果:

text
[INFO] BUILD SUCCESS

命令成功后,项目目录会生成 effective-pom.xml。在其中搜索目标 artifactId,可以核对继承、BOM 导入和当前 POM 覆盖完成后的最终管理结果。这个文件用于诊断,不应作为项目源 POM 提交并维护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

导入 BOM 管理依赖版本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通