构建与依赖 / 系统课时
创建聚合父项目
创建聚合父项目
聚合项目的作用是让多个 Maven 模块在一次命令中进入同一个 Reactor 构建。完成后,你会得到一个 packaging=pom 的根 POM,用 <modules> 声明子模块,并能从根目录执行 mvn validate 验证所有模块是否被正确收集。
学习目标
- 创建只负责聚合的根 POM,并正确设置
packaging为pom。 - 使用
<modules>按相对路径声明需要参与 Reactor 构建的模块。 - 通过 Maven Reactor 输出检查模块是否被发现,并定位常见路径错误。
先搭好聚合目录
先建立一个最小三目录工程。根目录只保存聚合 POM,api 和 service 各自拥有独立的 pom.xml。模块目录名不要求等于 artifactId,但 <module> 填的是相对根 POM 的目录路径,而不是坐标。
mkdir -p multi-demo/api multi-demo/service
cd multi-demo
printf '%s\n' "$PWD" "$(find . -maxdepth 1 -type d -print | sort)"预期输出
<PATH>/multi-demo
.
./api
./service其中 <PATH> 会随本机目录变化。目录只是容器,下一步还必须给根目录和每个模块放置可解析的 pom.xml。

声明参与构建的模块
根 pom.xml 必须有自己的 Maven 坐标,并把 packaging 设为 pom。<modules> 中的 api、service 都是目录路径;Maven 会继续读取这些目录里的 pom.xml。
<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>
<!-- 聚合器本身只提供工程组织,不产出普通 JAR。 -->
<groupId>com.example</groupId>
<artifactId>multi-demo</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<!-- module 值是相对当前 POM 的目录路径。 -->
<modules>
<module>api</module>
<module>service</module>
</modules>
</project>api/pom.xml 与 service/pom.xml 可以先保持最小化。这里故意不写 <parent>,因为聚合只依赖根 POM 的 <modules>,并不要求子模块继承根 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>
<!-- 不声明 parent,用来验证“聚合”和“继承”可以分开存在。 -->
<groupId>com.example</groupId>
<artifactId>api</artifactId>
<version>1.0.0-SNAPSHOT</version>
</project>把同样结构保存为 service/pom.xml,只把 artifactId 改为 service。配置生效的判断标准不是“文件存在”,而是根目录构建时 Reactor 同时列出根项目、api 和 service。
从根目录运行并验证
在 multi-demo 根目录执行 validate。这个阶段不会编译 Java 源码,适合只检查 POM、模块发现与模型解析是否正常。
mvn validate预期输出
[INFO] Reactor Build Order:
[INFO]
[INFO] multi-demo
[INFO] api
[INFO] service
...
[INFO] Reactor Summary for multi-demo 1.0.0-SNAPSHOT:
[INFO] multi-demo ......................................... SUCCESS
[INFO] api ................................................ SUCCESS
[INFO] service ............................................ SUCCESS
[INFO] BUILD SUCCESS日志中的耗时、时间戳和下载信息会随环境变化;验收时只需确认三个项目都进入 Reactor 且最终为 BUILD SUCCESS。如果模块之间存在依赖,Reactor 还会按依赖关系调整实际构建顺序。
常见失败与修复
最常见错误是把 <module> 写成 artifactId 或错误路径。例如模块实际在 modules/api,根 POM 却写 <module>api</module>,Maven 会报告子模块不存在。正确写法应改为 <module>modules/api</module>,并确保该目录内存在 pom.xml。
当根目录 mvn validate 能稳定看到全部模块后,聚合骨架才算创建完成。后续再加入模块间依赖、统一版本或插件配置,可以分别建立在 Reactor 聚合与 POM 继承机制之上。