---

title: 基于Apache Maven构建多模块项目
date: 2022-04-10 00:00:00
tags:

• Apache Maven
• 多模块
  categories:
• Maven

---

介绍

• 多模块项目由管理一组子模块的聚合器 POM 来构建。在大多数情况下聚合器位于项目的根目录中，并且必须是 pom 类型的项目。
• 子模块是常规的 Maven 项目，它们可以单独构建，也可以通过聚合器 POM 构建。
• 通过聚合器 POM 构建项目时会一并构建下属的所有子模块。

多模块的优势

• 减少重复
• 共享依赖项和配置文件

父 POM

• 可以创建自己的 pom.xml 文件，并作为父项目。
• 在每个子模块的 pom.xml 文件中声明对父 POM 的继承依赖关系。
• 父项目中另外也要声明其所属的子模块。
• 父项目也可以单继承另一个父项目。

构建应用程序

设想这个应用程序包含四个模块，它们分别是：

模块名称	独立部署	说明
commons	否	公共子模块
service	否	业务逻辑子模块
web	是	Web服务子模块
job	是	后台任务子模块

创建父POM

1. 新增一个常规项目 msa-order
2. 在 pom.xml 文件中增加 <packaging>pom</packaging>
3. 声明子模块中需要复用的依赖或配置，例如：

<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.6.6</version><relativePath/>
</parent><properties><java.version>11</java.version>
</properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-webflux</artifactId></dependency>
</dependencies>

创建子模块

1. 依次创建四个常规项目
2. 在父 pom.xml 文件的 modules 元素中添加子模块

<modules><module>commons</module><module>service</module><module>web</module><module>job</module>
</modules>

3. 在各个子模块的 pom.xml 文件中添加对父项目的依赖

<parent><artifactId>msa-order-parent</artifactId><groupId>com.tianmingxing.demo</groupId><version>1.0.0-SNAPSHOT</version>
</parent>

构建项目

1. 在父项目下执行 mvn package，这将构建所有模块其输出如下：

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for msa-order 1.0.0-SNAPSHOT:
[INFO] 
[INFO] msa-order .......................................... SUCCESS [  0.003 s]
[INFO] commons ............................................ SUCCESS [  1.625 s]
[INFO] service ............................................ SUCCESS [  0.056 s]
[INFO] web ................................................ SUCCESS [  0.891 s]
[INFO] job ................................................ SUCCESS [  0.110 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

2. 构建顺序：

• 项目依赖于构建中的另一个模块
• 插件声明，其中插件是构建中的另一个子模块
• 插件依赖于构建中的另一个模块
• 构建中另一个模块的构建扩展声明
• <modules> 元素中声明的顺序

3. 可以指定构建的模块，例如本次只想构建web子模块以及它依赖的其它模块，则可以使用命令 mvn -DskipTests=true package -pl web -am。

---

源码下载