本文档旨在指导开发者如何在Maven项目中利用Bill of Materials (BOM) 来管理依赖，以替代传统的继承 Spring Boot Parent POM 的方式。我们将深入探讨BOM的配置和使用，并提供一个实际案例，帮助您解决依赖管理中的常见问题，确保项目能够正确下载和使用所需的依赖项。
理解 Maven BOM (Bill of Materials)
Maven BOM (Bill of Materials) 是一种特殊的 POM 文件，它定义了一组依赖项的版本信息，但不引入实际的依赖。通过在 dependencyManagement 节中导入 BOM，您可以集中管理项目的依赖版本，避免版本冲突，并简化依赖声明。使用BOM，你无需为每个依赖显式指定版本，Maven 会自动从 BOM 中获取。
如何使用 Spring Boot BOM
要使用 Spring Boot BOM 替代 parent POM，你需要执行以下步骤：
移除 parent POM： 从 pom.xml 文件中移除 <parent> 标签。
-
添加 BOM 依赖： 在 dependencyManagement 节中，添加 Spring Boot BOM 作为依赖项，并设置 scope 为 import 和 type 为 pom。
<dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>${spring-boot.version}</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> -
声明依赖： 在 dependencies 节中，声明你需要的 Spring Boot 依赖项，无需指定版本。Maven 会自动从 Spring Boot BOM 中解析版本。
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies>
示例：使用 Spring Boot BOM 的 pom.xml 文件
下面是一个完整的 pom.xml 文件的示例，展示了如何使用 Spring Boot BOM 来管理依赖：
<?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">
<modelVersion>4.0.0</modelVersion>
<groupId>org.example</groupId>
<artifactId>bom-experiments</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<junit-jupiter.version>5.7.2</junit-jupiter.version>
<aws-sdk.version>2.18.16</aws-sdk.version>
<mockito-inline.version>4.8.0</mockito-inline.version>
<org.springframework.boot.version>2.7.5</org.springframework.boot.version>
<org.springframework.version>5.3.24</org.springframework.version>
<lombok.version>1.18.24</lombok.version>
<maven-compiler-plugin.version>3.10.1</maven-compiler-plugin.version>
<maven-surefire-plugin.version>3.0.0-M7</maven-surefire-plugin.version>
<junit-jupiter-params.version>${junit-jupiter.version}</junit-jupiter.version>
<kubernetes-maven-plugin.version>1.9.0</kubernetes-maven-plugin.version>
<!-- Plugins -->
<mockito.version>4.9.0</mockito.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-framework-bom</artifactId>
<version>${org.springframework.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${org.springframework.boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>software.amazon.awssdk</groupId>
<artifactId>bom</artifactId>
<version>${aws-sdk.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.junit</groupId>
<artifactId>junit-bom</artifactId>
<version>${junit-jupiter.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-bom</artifactId>
<version>${mockito.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- Secret managers -->
<dependency>
<groupId>software.amazon.awssdk</groupId>
<artifactId>secretsmanager</artifactId>
</dependency>
<dependency>
<groupId>software.amazon.awssdk</groupId>
<artifactId>ssm</artifactId>
</dependency>
<dependency>
<groupId>software.amazon.awssdk</groupId>
<artifactId>sts</artifactId>
</dependency>
<!-- Lombok -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>${lombok.version}</version>
<scope>provided</scope>
</dependency>
<!-- Testing -->
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-engine</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-inline</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-junit-jupiter</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-params</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<finalName>bom-experiments</finalName>
<sourceDirectory>${project.basedir}/src/main</sourceDirectory>
<testSourceDirectory>${project.basedir}/src/test</testSourceDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>${maven-surefire-plugin.version}</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>${maven-compiler-plugin.version}</version>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${org.springframework.boot.version}</version>
</plugin>
</plugins>
</build>
</project>注意：
- 确保 spring-boot.version 属性与你想要使用的 Spring Boot 版本一致。
- <sourceDirectory> 必须指向正确的源代码目录，通常是 ${project.basedir}/src/main。如果指向错误的位置，会导致编译错误。
解决依赖未下载的问题
如果在添加 BOM 后，仍然遇到依赖未正确下载的问题，可以尝试以下方法：
- 检查 dependencyManagement 配置： 确保 BOM 依赖项的 type 设置为 pom，scope 设置为 import。
- 清理和重新构建项目： 运行 mvn clean install 命令清理项目并重新构建。
- 检查 Maven 仓库： 确保 Maven 能够访问所需的仓库，并且依赖项已存在于仓库中。
- 检查 IDE 配置： 确保你的 IDE (如 IntelliJ IDEA 或 Eclipse) 已正确配置 Maven，并且能够解析依赖项。
总结
使用 Spring Boot BOM 可以有效地管理项目的依赖版本，避免版本冲突，并简化依赖声明。通过正确配置 dependencyManagement 节，并确保源代码目录设置正确，你可以成功地使用 BOM 替代 parent POM。如果在使用过程中遇到问题，请仔细检查配置，并尝试清理和重新构建项目。
