构建与依赖 / 系统课时
父 POM 的继承机制
父 POM 的继承机制
Maven 子项目通过 <parent> 先找到父 POM,再把可继承的属性、依赖管理和构建配置合并进自己的有效模型。理解这套合并规则后,你就能把公共配置放在正确层级,并用 effective-pom 验证最终结果。
学习目标
- 看懂
<parent>的坐标与relativePath如何定位父 POM。 - 判断属性、依赖管理、插件管理等配置是否会被子模块继承。
- 用有效 POM 检查继承后的真实配置。
parent 如何定位父 POM
子模块至少通过父项目的 groupId、artifactId、version 标识父 POM。relativePath 默认是 ../pom.xml;父 POM 不在这个位置时,可以写实际相对路径,若写成空的 <relativePath/>,则跳过默认相对路径查找,转而按父坐标从可用的 Maven 模型来源解析。

父 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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>company-parent</artifactId>
<version>1.0.0</version>
<packaging>pom</packaging>
<properties>
<maven.compiler.release>17</maven.compiler.release>
<commons-lang3.version>3.14.0</commons-lang3.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>${commons-lang3.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.2.5</version>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>子模块只保留自身差异:
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.example</groupId>
<artifactId>company-parent</artifactId>
<version>1.0.0</version>
<relativePath>../pom.xml</relativePath>
</parent>
<artifactId>app</artifactId>
<dependencies>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>这里子模块没有重复写项目 groupId、项目 version、commons-lang3 版本或 Surefire 版本,它们都会从父模型得到对应值。
哪些配置会继承
父 POM 会把大量模型内容交给子 POM,但不是所有字段都按同一种方式处理。下面这组规则足够覆盖日常多模块项目。
| 配置 | 常见继承结果 | 实际用法 |
|---|---|---|
项目 groupId、version |
子项目省略时继承 | 让一组模块共享发布坐标前缀与版本 |
properties |
继承,可在子项目覆盖 | 统一 Java 版本、编码、依赖版本变量 |
dependencyManagement |
继承管理规则,不自动引入依赖 | 子模块声明依赖时省略版本 |
dependencies |
通常直接继承 | 只放所有子模块都真正需要的依赖 |
build/pluginManagement |
继承插件版本和默认配置 | 统一 Surefire、Compiler 等插件规则 |
build/plugins |
默认可继承,插件可用 inherited 控制 |
统一确实要在子模块执行的构建行为 |
artifactId |
不继承 | 每个子项目必须有自己的构件名 |
name |
不应依赖父值 | 各模块按需填写可读名称 |
例如 8 个模块只有 2 个需要 JDBC 驱动时,不要把驱动放进父 POM 的 dependencies,否则其余 6 个模块也会继承;应把版本放进 dependencyManagement,再由那 2 个模块自行声明。
用 effective-pom 验证合并结果
进入子模块目录执行 Maven Help Plugin:
mvn help:effective-pom -Doutput=effective-pom.xml预期结果是在当前目录生成 effective-pom.xml。文件很长,但应能找到类似下面的关键片段,说明父项目中的版本已经合并进子项目模型:
<groupId>com.example</groupId>
<artifactId>app</artifactId>
<version>1.0.0</version>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.14.0</version>
</dependency>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.2.5</version>
</plugin>如果 effective-pom.xml 里没有预期版本,先检查 <parent> 的三段坐标是否完全一致,再检查 relativePath 是否指向正确 POM,最后看子模块是否用同名属性或更近层级的管理配置覆盖了父值。
继承和聚合不要混为一谈
继承由子 POM 的 <parent> 建立,聚合则由某个 POM 的 <modules> 决定“执行一次 Maven 命令时要同时构建哪些模块”。两者经常写在同一个根 POM 中,但并不是同一机制。
例如根 POM 可以通过 <modules> 聚合 app 和 service,而两个模块都继承 company-parent;也可以让一个公司级父 POM 只提供规则、完全不聚合任何业务模块。判断时看两个问题:配置从哪里继承,就查 <parent>;哪些模块一起进入 Reactor 构建,就查 <modules>。
把公共版本放进 dependencyManagement、公共插件版本放进 pluginManagement、真正所有模块都需要的配置才放进可直接继承区域,最后用 help:effective-pom 核对实际模型,能避免父 POM 越写越大而难以判断配置来源。