构建与依赖 / 系统课时
模块间依赖与构建顺序
模块间依赖与构建顺序
多模块工程里,<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> 的声明顺序排列。

根 POM 的模块列表可以这样写。这里是片段示例,依赖上下文是一个 packaging 为 pom 的聚合父工程。
<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。
<dependency>
<groupId>com.example</groupId>
<artifactId>core</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>把这段放进 service 的 <dependencies>;在 app 中将 artifactId 改为 service。如果只把版本写进 <dependencyManagement> 而没有真正声明 <dependency>,它不会形成项目依赖边,不能靠它保证模块构建先后。
在项目根目录执行一次验证阶段即可观察 Reactor 排序;不需要先 install。
mvn validate预期结果:日志的 Reactor Build Order 中,父 POM 若参与构建会在业务模块之前;三个业务模块的相对顺序应为:
core
service
app实际日志还会包含版本、打包类型和 Maven 自身信息,但只要这三个业务模块保持上述相对顺序,就说明依赖排序符合预期。
顺序不对时按三处排查
先确认目标模块真的进入 Reactor:根 POM 的 <modules> 路径必须指向存在的模块目录。再确认依赖写在 <dependencies>,且 groupId、artifactId、version 与 Reactor 中的目标项目一致。最后检查是否出现 core → service → core 这类循环依赖;循环会让 Reactor 无法得到合法拓扑顺序。
如果某模块只是通过同版本号引用了本地仓库里的旧构件,而没有与当前 Reactor 项目匹配,Maven 可能不会把它当作当前工程内的依赖来联动构建。排查时优先核对坐标和版本,而不是反复执行 install 掩盖问题。