前言

在 Spring Boot 的开发实践中，依赖管理是构建高质量应用的基础。spring-boot-starter-parent 和 spring-boot-dependencies 是 Spring Boot 提供的两大核心依赖管理工具，它们在简化依赖版本控制、统一配置等方面发挥着关键作用。

一、核心概念解析

1.1 spring-boot-starter-parent

• 定义：
  是一个 Maven 父 POM，提供默认的项目配置（如编码、插件、资源处理）和依赖版本管理。
• 核心功能：
  • 依赖版本管理：通过继承 spring-boot-dependencies，自动管理所有 Spring Boot 依赖的版本。
  • 默认配置：
    • 编译参数（如 Java 版本、编码格式）。
    • 插件配置（如 maven-compiler-plugin、spring-boot-maven-plugin）。
    • 资源处理（自动替换 application.properties 中的占位符）。
  • 标准化构建：确保多模块项目的一致性。

1.2 spring-boot-dependencies

• 定义：
  是一个 BOM（Bill of Materials），仅管理依赖版本，不提供其他配置。
• 核心功能：
  • 版本集中控制：通过 <dependencyManagement> 声明所有依赖的版本。
  • 兼容性保障：确保 Spring Boot 生态内依赖的版本兼容性。
  • 灵活性：可与现有父 POM 结合使用，避免替换原有配置。

1.3 核心关系图

---

二、核心区别对比

2.1 核心差异表

特性	spring-boot-starter-parent	spring-boot-dependencies
类型	Maven 父 POM	BOM（依赖版本清单）
作用范围	依赖版本管理 + 默认配置（插件、编码、资源处理）	仅依赖版本管理
继承关系	继承自 spring-boot-dependencies	独立存在，不依赖其他 POM
使用方式	通过 <parent> 标签继承	通过 <dependencyManagement> + <import> 引入
是否引入依赖	不直接引入依赖，但通过 BOM 管理版本	仅定义版本，不引入任何依赖

2.2 关键关系图

---

三、使用场景与最佳实践

3.1 spring-boot-starter-parent 的适用场景

• 新建 Spring Boot 项目：
  作为父 POM 直接继承，快速搭建标准化项目。

  <!-- pom.xml -->
  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>3.2.0</version>
      <relativePath/> <!-- 从 Maven 仓库获取 -->
  </parent>
  

• 统一配置需求：
  需要统一 Java 版本、编码、插件配置的多模块项目。

3.2 spring-boot-dependencies 的适用场景

• 已有父 POM 的项目：
  不想替换原有父 POM，但需管理 Spring Boot 依赖版本。

  <!-- pom.xml -->
  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-dependencies</artifactId>
              <version>3.2.0</version>
              <type>pom</type>
              <scope>import</scope>
          </dependency>
      </dependencies>
  </dependencyManagement>
  

• 灵活版本覆盖：
  需要自定义部分依赖版本时，通过 <properties> 覆盖。

  <properties>
      <junit-jupiter.version>5.9.3</junit-jupiter.version>
  </properties>
  

---

四、代码示例与实战

4.1 使用 spring-boot-starter-parent 的完整项目配置

<!-- pom.xml -->
<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.0</version>
    </parent>
    
    <properties>
        <java.version>17</java.version>
    </properties>

    <dependencies>
        <!-- 自动继承版本 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!-- 内置的 spring-boot-maven-plugin 插件 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

4.2 使用 spring-boot-dependencies 的独立配置

<!-- pom.xml -->
<project>
    <modelVersion>4.0.0</modelVersion>
    
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>3.2.0</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <!-- 需要显式指定插件 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

    <!-- 手动配置插件 -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

---

五、高级技巧与最佳实践

5.1 覆盖依赖版本

在 spring-boot-starter-parent 中，通过 <properties> 覆盖版本：

<properties>
    <junit-jupiter.version>5.9.3</junit-jupiter.version>
    <logback.version>1.2.11</logback.version>
</properties>

5.2 自定义父 POM

若需扩展功能，可创建自己的父 POM：

<!-- custom-parent/pom.xml -->
<project>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.0</version>
    </parent>
    
    <groupId>com.example</groupId>
    <artifactId>custom-parent</artifactId>
    
    <properties>
        <java.version>17</java.version>
    </properties>
    
    <dependencyManagement>
        <!-- 自定义依赖版本 -->
    </dependencyManagement>
</project>

5.3 版本冲突解决

通过 spring-boot-dependencies 确保版本一致性：

<!-- 依赖声明 -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>custom-library</artifactId>
    <version>1.0.0</version> <!-- 手动指定版本 -->
</dependency>

---

六、总结与选择建议

6.1 核心总结

场景	推荐方案	原因
新项目快速搭建	spring-boot-starter-parent	提供默认配置，开箱即用
已有父 POM 的项目	spring-boot-dependencies	灵活管理版本，不破坏现有配置
需要完全控制配置	spring-boot-dependencies	自定义插件、编码等细节

6.2 选择建议

• 优先使用 spring-boot-starter-parent：
  当项目需要统一配置（如插件、编码、资源处理），且无现有父 POM 限制时。
• 选择 spring-boot-dependencies：
  当需要与现有父 POM 结合，或需自定义依赖版本时。

---

七、常见问题解答

7.1 为什么 spring-boot-starter-parent 需要继承 spring-boot-dependencies？

• 原因：spring-boot-starter-parent 通过继承 spring-boot-dependencies 的 BOM，确保依赖版本的统一管理，避免版本冲突。

7.2 如何验证依赖版本是否被正确管理？

• 方法：
  使用 mvn dependency:tree 命令查看依赖树，确认版本是否符合预期。

---

八、总结

• spring-boot-starter-parent 是“一站式”解决方案，适合快速搭建标准Spring Boot项目。
• spring-boot-dependencies 是轻量级的依赖版本管理工具，适合需要灵活控制配置的复杂场景。
• 关键关系：spring-boot-starter-parent 内部已继承 spring-boot-dependencies，因此前者包含了后者的所有功能，但额外提供了默认配置。