构建与依赖 / 系统课时
聚合与继承的区别
聚合与继承的区别
<modules> 与 <parent> 经常写在同一个根 POM 中,因此很容易被当成一件事。实际工程里它们解决的是两个独立问题:聚合决定“这次一起构建谁”,继承决定“子项目从谁那里拿默认配置”。区分清楚后,才能设计可拆分、可单独构建的多模块项目。
学习目标
- 判断
<modules>与<parent>分别影响 Reactor 构建还是 POM 配置继承。 - 看懂一个 POM 同时承担聚合器与父 POM 两种角色时的实际行为。
- 用命令验证继承结果,并能根据工程边界决定两种关系是否都需要。
先用两个判断问题区分
看到多模块工程时,先问两个问题。第一,根目录执行 Maven 时,哪些项目要被自动加入同一次 Reactor?这由聚合 POM 的 <modules> 决定。第二,某个子项目没有显式写版本、属性或插件配置时,它从哪里获得这些值?这由子 POM 的 <parent> 决定。
| 机制 | 写在谁的 POM | 关键元素 | 直接作用 |
|---|---|---|---|
| 聚合 | 聚合器 | <modules> / <module> |
把多个项目加入同一次 Reactor 构建 |
| 继承 | 子项目 | <parent> |
继承父 POM 的 groupId、version、属性及可继承配置 |

看一个同时聚合又继承的工程
下面的根 POM 同时声明 <modules> 和公共属性,因此它既是聚合器,也可以被子模块作为父 POM。maven.compiler.release 设置为 17,便于后面用命令验证继承是否发生。
<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>demo-root</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<!-- modules 只决定 Reactor 成员。 -->
<modules>
<module>app</module>
<module>lib</module>
</modules>
<properties>
<maven.compiler.release>17</maven.compiler.release>
</properties>
</project>app/pom.xml 通过 <parent> 指向上一级 POM,因此不用重复写 groupId 和 version,也会继承 maven.compiler.release=17。
<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>
<!-- 未写 relativePath 时,Maven 默认先检查 ../pom.xml。 -->
<parent>
<groupId>com.example</groupId>
<artifactId>demo-root</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<artifactId>app</artifactId>
</project>这里有两条独立关系:根 POM 因为 <module>app</module> 会把 app 聚合进 Reactor;app 因为 <parent> 会继承根 POM。任意删除其中一条,另一条关系仍可存在。
用命令验证继承结果
从根目录读取 app 的有效属性,可以直接验证父 POM 是否提供了 Java release 值。-pl app 选择 Reactor 中的 app 项目,help:evaluate 读取模型表达式。
mvn -q -pl app help:evaluate -Dexpression=maven.compiler.release -DforceStdout预期输出
17如果删除 app/pom.xml 的 <parent>,又没有在 app 自己定义该属性,上述表达式将不再得到继承值。反过来,如果只从根 POM 的 <modules> 删除 app,但保留 <parent>,app 仍然可以继承根 POM;只是根目录的 Reactor 不会再自动把它作为模块加入构建。
按工程边界选择关系
同一仓库的业务模块通常既需要聚合,也需要继承:根 POM 统一 Java 版本、依赖和插件策略,同时一次构建全部模块。共享给多个仓库的企业父 POM 则常常只做继承,不在其中列出各业务仓库的 <modules>。
设计时不要用目录层级代替关系判断。子项目位于根目录下面,不代表它自动被聚合;子 POM 省略了 groupId 和 version,也只有在 <parent> 可解析时才成立。分别检查 Reactor 成员与有效 POM,能最快确认工程关系是否符合预期。