构建与依赖 / 系统课时

模块间依赖与构建顺序

模块间依赖与构建顺序

多模块工程里,<modules> 只决定哪些子项目进入 Reactor,并不等于最终构建顺序。真正的先后关系由模块间依赖等约束决定。这里用 core → service → app 三层工程说明怎样声明依赖、怎样读 Reactor 顺序,以及顺序异常时先查哪里。

学习目标

  • 能区分聚合关系与模块依赖关系,知道 <modules> 与 <dependency> 各自解决什么问题。
  • 能根据模块依赖图判断 Reactor 的构建先后,并用 Maven 日志验证实际顺序。
  • 能定位依赖未进入 Reactor、循环依赖和只写 dependencyManagement 等常见问题。

Reactor 按依赖关系排序

假设根工程声明 app、core、service,故意不是业务依赖顺序;实际关系是 app 依赖 service,service 依赖 core。Reactor 会先满足依赖约束,因此业务模块仍应按 core → service → app 构建。没有依赖约束的并列模块,才可能按 <modules> 的声明顺序排列。

Reactor 依赖图与构建顺序

根 POM 的模块列表可以这样写。这里是片段示例,依赖上下文是一个 packaging 为 pom 的聚合父工程。

xml
<modules>
  <module>app</module>
  <module>core</module>
  <module>service</module>
</modules>

这个配置只把三个目录加入本次 Reactor;它不会表达 app 必须等待 service。验证顺序还要看各模块的真实依赖声明。

用 dependency 建立模块先后关系

service/pom.xml 需要直接依赖 core,app/pom.xml 再直接依赖 service。下面同样是片段示例,假设三个模块的 groupId 都是 com.example,版本统一为 1.0-SNAPSHOT。

xml
<dependency>
  <groupId>com.example</groupId>
  <artifactId>core</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

把这段放进 service 的 <dependencies>;在 app 中将 artifactId 改为 service。如果只把版本写进 <dependencyManagement> 而没有真正声明 <dependency>,它不会形成项目依赖边,不能靠它保证模块构建先后。

在项目根目录执行一次验证阶段即可观察 Reactor 排序;不需要先 install。

bash
mvn validate

预期结果:日志的 Reactor Build Order 中,父 POM 若参与构建会在业务模块之前;三个业务模块的相对顺序应为:

text
core
service
app

实际日志还会包含版本、打包类型和 Maven 自身信息,但只要这三个业务模块保持上述相对顺序,就说明依赖排序符合预期。

顺序不对时按三处排查

先确认目标模块真的进入 Reactor:根 POM 的 <modules> 路径必须指向存在的模块目录。再确认依赖写在 <dependencies>,且 groupId、artifactId、version 与 Reactor 中的目标项目一致。最后检查是否出现 core → service → core 这类循环依赖;循环会让 Reactor 无法得到合法拓扑顺序。

如果某模块只是通过同版本号引用了本地仓库里的旧构件,而没有与当前 Reactor 项目匹配,Maven 可能不会把它当作当前工程内的依赖来联动构建。排查时优先核对坐标和版本,而不是反复执行 install 掩盖问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

模块间依赖与构建顺序

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

登录哪都通