本文系统讲解maven中插件执行顺序的底层机制，重点解决“同一生命周期阶段内多个插件如何按需排序”这一高频难题，涵盖默认规则、id字母序控制、跨阶段解耦等实战策略，并提供可直接复用的pom配置示例。
本文系统讲解maven中插件执行顺序的底层机制，重点解决“同一生命周期阶段内多个插件如何按需排序”这一高频难题，涵盖默认规则、id字母序控制、跨阶段解耦等实战策略，并提供可直接复用的pom配置示例。
在Maven构建过程中，插件（Plugin）本身不决定执行时机，而是通过绑定（binding）到生命周期（Lifecycle）的特定阶段（Phase）来触发。Maven拥有三套独立生命周期：clean、default（即构建主生命周期）和 site；每个生命周期由一系列严格有序的阶段组成（如 compile → test → package → install），且执行任一阶段时，Maven会自动从前置阶段顺序执行至目标阶段——这是理解插件顺序的前提。
✅ 正确控制插件执行顺序的核心原则
Maven官方明确指出：同一阶段（Phase）内，多个插件执行顺序由
- 所有绑定到 compile 阶段的插件（含多个
），将按其 字符串升序排列后依次执行； - 若未显式指定
，Maven默认使用 "default"，导致多个无ID的execution无法区分先后； - 同一插件内多个
可共存于同一阶段，但必须赋予唯一且可排序的 。
⚠️ 重要提醒：你遇到的“前后echo消息均在antrun前输出”，根本原因在于——Maven不保证不同插件间的execution跨插件排序（即使同属compile阶段）。它仅对同一插件内的多个execution按id排序；而不同插件的execution在同阶段内属于“并列绑定”，实际执行顺序依赖于插件解析顺序，具有不确定性，不应依赖。
✅ 推荐方案：用阶段解耦替代同阶段硬排序（最稳定）
最佳实践是避免在同一阶段强行混合多个插件逻辑，而是利用Maven生命周期天然的线性顺序，将“前置动作→主任务→后置动作”拆分到相邻阶段：
| 阶段 | 推荐用途 | 示例插件 |
|---|---|---|
| process-classes | 编译完成后、测试前的准备动作（如打印提示、资源预处理） | echo-maven-plugin |
| test | 执行核心任务（如maven-antrun-plugin:run） | maven-antrun-plugin |
| prepare-package | 测试通过后、打包前的收尾动作（如日志归档、状态校验） | echo-maven-plugin |
✅ 正确配置示例（推荐）：
<build>
<plugins>
<!-- Step 1: 在 process-classes 阶段打印前置提示 -->
<plugin>
<groupId>com.soebes.maven.plugins</groupId>
<artifactId>echo-maven-plugin</artifactId>
<version>0.5.0</version>
<executions>
<execution>
<id>echo-before-antrun</id>
<phase>process-classes</phase> <!-- 注意：非 compile -->
<goals>
<goal>echo</goal>
</goals>
<configuration>
<echos>
<echo>[INFO] ✅ Starting maven-antrun-plugin execution...</echo>
</echos>
</configuration>
</execution>
</executions>
</plugin>
<!-- Step 2: 在 test 阶段执行核心antrun任务 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-antrun-plugin</artifactId>
<executions>
<execution>
<id>run-custom-tasks</id>
<phase>test</phase> <!-- 关键：移至 test 阶段 -->
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<!-- 你的Ant任务 -->
<echo message="Running custom build logic..." />
</tasks>
</configuration>
</execution>
</executions>
</plugin>
<!-- Step 3: 在 prepare-package 阶段打印后置提示 -->
<plugin>
<groupId>com.soebes.maven.plugins</groupId>
<artifactId>echo-maven-plugin</artifactId>
<version>0.5.0</version>
<executions>
<execution>
<id>echo-after-antrun</id>
<phase>prepare-package</phase> <!-- 注意：非 compile -->
<goals>
<goal>echo</goal>
</goals>
<configuration>
<echos>
<echo>[INFO] ✅ maven-antrun-plugin completed successfully.</echo>
</echos>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>✅ 优势：完全符合Maven设计哲学，零歧义、零兼容性风险，适用于所有Maven版本（3.0+）。
⚙️ 进阶技巧：同阶段内精细控制（慎用）
若因架构限制必须同阶段执行，可采用以下方式（仅作补充了解）：
强制ID字典序控制（同一插件内）：
将所有逻辑收敛至单个插件（如自定义Groovy插件），通过多个+ 有序 （如 a-before, b-main, c-after）实现确定性顺序。 使用maven-exec-plugin封装Shell/Java逻辑：
用单个exec:java或exec:exec统一调度多步骤，规避插件调度不确定性。禁用默认绑定，全手动重绑定：
通过统一管理，并在子模块中显式重绑定各插件到不同phase，提升可维护性。
? 总结与最佳实践
| 场景 | 推荐做法 | 风险提示 |
|---|---|---|
| 需要“前→中→后”清晰时序 | 拆分到相邻标准阶段（如 process-classes → test → prepare-package） | ✅ 最稳定、最易读、最符合Maven规范 |
| 多插件同阶段且必须排序 | 使用同一插件多个execution + 有序 |
⚠️ 仅限同一插件内；不同插件间仍不可靠 |
| 快速验证/临时调试 | 使用 -DskipTests 或 mvn -X 查看DEBUG日志确认实际执行流 | ❌ 切勿在生产POM中依赖解析顺序 |
最后，请牢记Maven的黄金法则：“Phase defines when, Plugin defines what, Execution ID defines order within same plugin.” —— 理解并尊重这一分层设计，才能写出健壮、可演进的构建脚本。
