构建与依赖 / 系统课时

创建聚合父项目

创建聚合父项目

聚合项目的作用是让多个 Maven 模块在一次命令中进入同一个 Reactor 构建。完成后,你会得到一个 packaging=pom 的根 POM,用 <modules> 声明子模块,并能从根目录执行 mvn validate 验证所有模块是否被正确收集。

学习目标

  • 创建只负责聚合的根 POM,并正确设置 packaging 为 pom。
  • 使用 <modules> 按相对路径声明需要参与 Reactor 构建的模块。
  • 通过 Maven Reactor 输出检查模块是否被发现,并定位常见路径错误。

先搭好聚合目录

先建立一个最小三目录工程。根目录只保存聚合 POM,api 和 service 各自拥有独立的 pom.xml。模块目录名不要求等于 artifactId,但 <module> 填的是相对根 POM 的目录路径,而不是坐标。

bash
mkdir -p multi-demo/api multi-demo/service
cd multi-demo
printf '%s\n' "$PWD" "$(find . -maxdepth 1 -type d -print | sort)"

预期输出

text
<PATH>/multi-demo
.
./api
./service

其中 <PATH> 会随本机目录变化。目录只是容器,下一步还必须给根目录和每个模块放置可解析的 pom.xml。

聚合项目目录与Reactor关系

声明参与构建的模块

根 pom.xml 必须有自己的 Maven 坐标,并把 packaging 设为 pom。<modules> 中的 api、service 都是目录路径;Maven 会继续读取这些目录里的 pom.xml。

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。

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>

  <!-- 不声明 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、模块发现与模型解析是否正常。

bash
mvn validate

预期输出

text
[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 继承机制之上。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建聚合父项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通