詳細講解 Spring Boot 項目中的 POM 配置
作者：張慧源
本文詳細介紹了 Spring Boot 項目中 POM 文件的配置，涵蓋了單模塊項目和多模塊項目的常見配置場景。 SpringBoot
在 Spring Boot 項目中，POM（Project Object Model）文件起著關鍵作用，它定義了項目的依賴關系、構建配置等重要信息。無論是單模塊項目還是多模塊項目，合理的 POM 配置能使開發變得更加高效和簡便。
本篇文章將詳細講解 Spring Boot 項目中 POM 文件的配置，涵蓋單模塊項目和多模塊項目的 POM 配置方式。通過實際代碼示例，幫助你理解和掌握如何高效管理 Spring Boot 項目的依賴和構建。
一、POM 文件簡介
POM 文件是 Maven 項目的核心配置文件，采用 XML 格式，用于描述項目及其依賴、插件、構建配置等信息。它可以指定：
- 項目的基本信息，如名稱、版本等
- 依賴管理：通過聲明依賴使項目自動下載所需的庫
- 插件管理：定義構建過程中需要的插件
- 繼承與聚合：支持多模塊項目管理
官方文檔: Maven POM Reference
二、單模塊項目的 POM 配置
1. 創建基本的 Spring Boot 單模塊項目
首先，我們來看一個基本的 Spring Boot 單模塊項目 POM 文件配置。通常單模塊項目的 POM 文件相對簡單，專注于定義項目依賴和構建配置。
示例 POM 文件：
<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>com.example</groupId>
<artifactId>springboot-demo</artifactId>
<version>1.0.0</version>
<packaging>jar</packaging>
<!-- Spring Boot Parent -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.1.0</version>
<relativePath/> <!-- 指定父項目 -->
</parent>
<properties>
<!-- Java 版本 -->
<java.version>17</java.version>
</properties>
<dependencies>
<!-- Spring Boot Web Starter -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 其他依賴可以根據項目需求添加 -->
</dependencies>
<build>
<plugins>
<!-- Spring Boot Maven 插件 -->
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>2. 重點解析
- parent ：通過聲明 spring-boot-starter-parent 作為父 POM，繼承了 Spring Boot 的默認配置，比如依賴管理、插件等。這極大簡化了項目配置。
- dependencies ：通過 dependencies 標簽引入 Spring Boot 的依賴包，如 spring-boot-starter-web，用于開發 Web 應用。
- properties ：定義 Java 版本，確保項目使用指定的 Java 環境。
- build ：通過 Spring Boot Maven 插件實現打包和運行。
三、多模塊項目的 POM 配置
在大型項目中，通常會使用多模塊結構來分離不同的功能模塊。每個子模塊都有自己的 POM 文件，而根模塊負責聚合這些子模塊。
1. 多模塊項目結構
典型的多模塊項目結構如下：
parent-project/
├── pom.xml （父 POM 文件）
├── module-a/
│ └── pom.xml （子模塊 A 的 POM）
├── module-b/
│ └── pom.xml （子模塊 B 的 POM）
└── module-c/
└── pom.xml （子模塊 C 的 POM）2. 父模塊 POM 文件
父模塊主要作用是聚合多個子模塊，并為子模塊提供統一的依賴和插件管理。
<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>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0</version>
<packaging>pom</packaging> <!-- 父項目的打包類型為 POM -->
<modules>
<module>module-a</module>
<module>module-b</module>
<module>module-c</module>
</modules>
<dependencyManagement>
<dependencies>
<!-- 子模塊可以繼承這些依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>3.1.0</version>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<!-- 統一的 Spring Boot 插件 -->
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>3. 子模塊 POM 文件
每個子模塊的 POM 文件可以繼承父模塊的配置，并根據實際需求添加特定的依賴和插件。
示例：子模塊 A 的 POM
<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://www.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0</version>
<relativePath/> <!-- 指向父項目 POM -->
</parent>
<artifactId>module-a</artifactId>
<dependencies>
<!-- 繼承自父項目的依賴可以不重復定義 -->
</dependencies>
</project>4. 重點解析
- modules ：父 POM 使用 modules 標簽聚合多個子模塊，實現集中構建和管理。
- dependencyManagement ：父 POM 定義了統一的依賴版本，子模塊無需重復指定版本，簡化管理。
- parent ：子模塊通過 parent 標簽繼承父模塊配置，減少重復配置。
結語
本文詳細介紹了 Spring Boot 項目中 POM 文件的配置，涵蓋了單模塊項目和多模塊項目的常見配置場景。通過合理配置 POM 文件，可以有效簡化項目的依賴管理和構建過程，提升開發效率。
在實踐中，你可以根據項目需求調整 POM 文件中的配置，并充分利用 Spring Boot 提供的父 POM 來簡化依賴和插件管理。
責任編輯：趙寧寧
來源：
源話編程
