前言

在 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，因此前者包含了后者的所有功能，但額外提供了默認配置。