在 maven 多模块项目中，若需从根模块（pom packaging）统一打包所有子模块产物（如 war、ear、tar），必须解决子模块尚未完成构建时主模块就提前执行 assembly 的时序问题。核心方案是调整插件绑定阶段或重构模块依赖关系。
在 maven 多模块项目中，若需从根模块（pom packaging）统一打包所有子模块产物（如 war、ear、tar），必须解决子模块尚未完成构建时主模块就提前执行 assembly 的时序问题。核心方案是调整插件绑定阶段或重构模块依赖关系。
Maven 的标准生命周期（clean → validate → compile → test → package → verify → install → deploy）是按模块顺序逐个执行完整生命周期，而非全局同步推进各阶段。这意味着：当执行 mvn clean verify 时，Maven 会先对 module1 执行到 verify 阶段，再对 module2 执行到 verify，依此类推；但根模块（mainapp）作为 pom 类型，其 <phase>package</phase> 绑定的 maven-assembly-plugin 会在自身生命周期的 package 阶段触发——而此时子模块虽已完成各自 package，但它们的输出（如 module1/target/*.war）默认不会自动复制到根模块的 target/ 目录下，导致 assembly 插件因找不到归档内容而报错 archive cannot be empty。
✅ 推荐方案一：引入专用聚合模块（推荐，符合 Maven 最佳实践）
新建一个独立的聚合子模块（例如 dist 或 assembly-module），将其声明为最后一个模块，并通过 <dependencies></dependencies> 显式依赖其他构建产物模块：
<!-- modules/dist/pom.xml -->
<project>
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.empresa.nombre.app</groupId>
<artifactId>mainapp</artifactId>
<version>1.0.0</version>
</parent>
<artifactId>dist</artifactId>
<packaging>pom</packaging>
<dependencies>
<!-- 确保这些模块已构建完成且其产物可被引用 -->
<dependency>
<groupId>com.empresa.nombre.app</groupId>
<artifactId>module1</artifactId>
<version>1.0.0</version>
<type>war</type>
</dependency>
<dependency>
<groupId>com.empresa.nombre.app</groupId>
<artifactId>module2</artifactId>
<version>1.0.0</version>
<type>tar</type>
</dependency>
<dependency>
<groupId>com.empresa.nombre.app</groupId>
<artifactId>module3</artifactId>
<version>1.0.0</version>
<type>ear</type>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<appendAssemblyId>false</appendAssemblyId>
<finalName>finalName</finalName>
<descriptors>
<descriptor>src/assembly/assembly.xml</descriptor>
</descriptors>
<outputDirectory>${project.build.directory}</outputDirectory>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>并在根 pom.xml 中将 dist 模块置于 <modules></modules> 列表末尾：
<modules> <module>module1</module> <module>module2</module> <module>module3</module> <module>dist</module> <!-- ← 确保最后构建 --> </modules>
✅ 优势：
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 利用 Maven 的 reactor 排序机制（依赖决定顺序），
dist模块天然在所有依赖模块之后执行； - 通过
<dependency></dependency>声明，Maven 自动将子模块构建产物解析为可用构件，assembly 插件可直接引用（无需手动拷贝）； - 符合单一职责原则，根 POM 专注结构定义，分发逻辑由专用模块承担。
⚠️ 方案二（不推荐）：强行绑定到 verify 阶段（临时规避）
仅作调试参考，不应用于生产：
<!-- 根 pom.xml 中 assembly 插件配置 --> <execution> <id>make-assembly</id> <phase>verify</phase> <!-- 改为 verify，晚于所有子模块的 package --> <goals><goal>single</goal></goals> </execution>
⚠️ 风险提示：
-
verify阶段语义是“运行集成测试与验证”，在此阶段生成分发包违反 Maven 生命周期契约，可能导致 CI/CD 流水线行为不可预测； - 仍无法保证子模块产物自动出现在根
target/下，通常需配合maven-dependency-plugin:copy手动拉取，增加复杂度与出错概率。
? 补充建议：优化 assembly 描述符
确保 assembly.xml 正确引用子模块输出。例如：
<!-- assembly.xml -->
<assembly xmlns="http://maven.apache.org/ASSEMBLY/2.1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.1.0 http://maven.apache.org/xsd/assembly-2.1.0.xsd">
<id>distribution</id>
<formats>
<format>zip</format>
</formats>
<includeBaseDirectory>true</includeBaseDirectory>
<dependencySets>
<dependencySet>
<useProjectArtifact>false</useProjectArtifact>
<outputDirectory>/lib</outputDirectory>
<includes>
<include>com.empresa.nombre.app:module1:war</include>
<include>com.empresa.nombre.app:module2:tar</include>
<include>com.empresa.nombre.app:module3:ear</include>
</includes>
</dependencySet>
</dependencySets>
</assembly>✅ 总结
要实现“子模块先构建完成，主模块最后打包”的可靠流程，唯一健壮的方式是引入专用聚合子模块（方案一）。它利用 Maven 内置的依赖驱动构建顺序与构件解析机制，避免时序竞争与路径硬编码，兼具可维护性与可扩展性。切勿依赖阶段偏移（如 verify）作为长期解决方案——这违背工具设计本意，终将带来技术债务。
