pom.xml父子模块配置

在 Maven 项目中，pom.xml的父子模块结构是实现项目模块化管理的核心机制，主要用于解决配置复用、版本统一、批量构建等问题。下面从概念、配置、作用及示例等方面详细讲解：

一、核心概念：父 POM 与子 POM

• 父 POM（Parent POM）：相当于 "模板"，定义了公共配置（如依赖版本、插件、属性等），供子模块继承。
• 子 POM（Child POM）：继承父 POM 的配置，专注于自身模块的特有配置（如模块专属依赖、资源等）。

父子关系本质是继承关系，同时父模块通常还承担聚合角色（通过modules标签管理子模块，实现批量构建）。

二、父 POM 的特点与配置

父 POM 的核心作用是抽取公共配置，避免子模块重复编写。其配置有以下特点：

1. 打包类型必须为pom

父模块本身不生成代码产物（如 JAR/WAR），仅用于管理，因此packaging标签必须设为pom：

<packaging>pom</packaging>

2. 定义公共配置（供子模块继承）

父 POM 中可定义的公共配置包括：

• properties：统一管理版本号、路径等常量（子模块可直接引用）。
• dependencyManagement：声明依赖版本（子模块引用时无需指定版本，统一由父模块管控）。
• pluginManagement：声明插件版本（类似依赖管理，子模块引用插件时无需指定版本）。
• build：公共的构建配置（如资源目录、插件等，子模块可继承或覆盖）。

3. 聚合子模块（modules标签）

父模块通过modules标签列出所有子模块的相对路径，实现 "一键构建所有子模块"（聚合功能）。
例如，父模块目录下有user-service和order-service两个子模块：

<modules><!-- 子模块的相对路径（指向子模块目录） --><module>user-service</module><module>order-service</module>
</modules>

三、子 POM 的特点与配置

子模块通过parent标签明确继承的父模块，从而复用父 POM 的配置。

1. 声明父模块（parent标签）

子 POM 必须通过parent标签指定父模块的groupId、artifactId、version（这三者唯一标识父模块），示例：

<parent><!-- 父模块的坐标 --><groupId>com.example</groupId><artifactId>parent-project</artifactId><version>1.0.0</version><!-- 父POM的相对路径（默认../pom.xml，可省略） --><relativePath>../pom.xml</relativePath>
</parent>

• relativePath：指定父 POM 的位置（默认查找父目录的pom.xml），若找不到则从 Maven 仓库下载。

2. 子模块的特有配置

子模块可省略与父模块相同的groupId和version（自动继承），只需定义自身的artifactId和特有配置：

<!-- 继承父模块的groupId和version，可省略 -->
<artifactId>user-service</artifactId>
<packaging>jar</packaging> <!-- 子模块通常为jar/war --><!-- 引用父模块dependencyManagement中声明的依赖（无需写version） -->
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><!-- 版本由父模块的dependencyManagement管控 --></dependency>
</dependencies>

四、关键区别：继承 vs 聚合

父子模块中，继承和聚合是两个独立但常结合使用的概念：

• 继承：子模块复用父模块的配置（解决 "配置重复" 问题）。
• 聚合：父模块通过modules管理子模块（解决 "批量构建" 问题）。

一个父模块可以只做聚合（不被继承），也可以只被继承（不做聚合），但实际开发中通常两者结合（既当父模块又当聚合模块）。

五、完整示例

假设项目结构如下：

parent-project/          # 父模块目录
├── pom.xml              # 父POM
├── user-service/        # 子模块1
│   └── pom.xml
└── order-service/       # 子模块2└── pom.xml

父 POM（parent-project/pom.xml）

<?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>com.example</groupId><artifactId>parent-project</artifactId><version>1.0.0</version><packaging>pom</packaging> <!-- 父模块必须为pom --><name>Parent Project</name><!-- 聚合子模块 --><modules><module>user-service</module><module>order-service</module></modules><!-- 公共属性（版本号等） --><properties><java.version>11</java.version><spring-boot.version>2.7.0</spring-boot.version></properties><!-- 依赖版本管理（子模块引用时无需写version） --><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><version>${spring-boot.version}</version></dependency></dependencies></dependencyManagement><!-- 公共插件配置 --><build><pluginManagement> <!-- 插件版本管理 --><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>${spring-boot.version}</version></plugin></plugins></pluginManagement></build>
</project>

子 POM（user-service/pom.xml）

<?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><!-- 继承父模块 --><parent><groupId>com.example</groupId><artifactId>parent-project</artifactId><version>1.0.0</version><relativePath>../pom.xml</relativePath> <!-- 父POM的位置 --></parent><!-- 子模块自身坐标（继承了groupId和version，只需写artifactId） --><artifactId>user-service</artifactId><name>User Service</name><!-- 引用父模块管理的依赖（无需版本） --><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- 子模块特有依赖 --><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.24</version> <!-- 父模块未管理，需显式指定 --></dependency></dependencies><!-- 继承父模块的插件配置（也可覆盖） --><build><plugins><!-- 引用父模块pluginManagement中的插件（无需版本） --><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>

六、总结

父子 POM 结构的核心价值在于：

1. 配置复用：公共配置（版本、插件）集中在父 POM，减少重复代码。
2. 版本统一：通过dependencyManagement和pluginManagement确保所有子模块依赖版本一致，避免冲突。
3. 批量操作：父模块通过modules聚合子模块，支持 "一键构建 / 打包所有子模块"。

实际开发中，Spring Boot 的spring-boot-starter-parent就是典型的父 POM，通过继承它可以快速获得 Spring Boot 的默认配置。