在 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 类型，其 maven-assembly-plugin 会在自身生命周期的 package 阶段触发——而此时子模块虽已完成各自 package，但它们的输出（如 module1/target/*.war）默认不会自动复制到根模块的 target/ 目录下，导致 assembly 插件因找不到归档内容而报错 archive cannot be empty。
✅ 推荐方案一：引入专用聚合模块（推荐，符合 Maven 最佳实践）
新建一个独立的聚合子模块（例如 dist 或 assembly-module），将其声明为最后一个模块，并通过
<!-- 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><module>module1</module><module>module2</module><module>module3</module><module>dist</module><!-- ← 确保最后构建 --></modules>
✅ 优势：
- 利用 Maven 的 reactor 排序机制（依赖决定顺序），
dist模块天然在所有依赖模块之后执行； - 通过
- 符合单一职责原则，根 POM 专注结构定义，分发逻辑由专用模块承担。
⚠️ 方案二（不推荐）：强行绑定到 verify 阶段（临时规避）
仅作调试参考，不应用于生产：
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
<!-- 根 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）作为长期解决方案——这违背工具设计本意，终将带来技术债务。
