本文系统讲解 Maven 中插件执行顺序的核心机制，重点解析如何在单个生命周期阶段内控制多个插件（如 echo-maven-plugin 与 maven-antrun-plugin）的精确执行先后关系，并指出依赖 字母序控制的局限性及更健壮的实践方案。
本文系统讲解 maven 中插件执行顺序的核心机制，重点解析如何在单个生命周期阶段内控制多个插件（如 echo-maven-plugin 与 maven-antrun-plugin）的精确执行先后关系，并指出依赖 `
在 Maven 构建过程中，“插件执行顺序”并非由开发者随意指定，而是严格遵循其生命周期（Lifecycle）→ 阶段（Phase）→ 插件绑定（Plugin Binding）→ 执行配置（Execution） 四层结构。尤其当多个插件被绑定到同一生命周期阶段（如 compile）时，Maven 的默认行为是：按
然而，正如问题中所验证的——即使为 echo-maven-plugin 配置了 echo-before-call-plugin 和 echo-after-call-plugin 两个 execution，且
✅ Maven 的执行粒度是
→ 同一
→ 不同
因此，以下写法无法实现“before → antrun → after”的预期流程：
<plugins><plugin><!-- echo plugin: 两个 execution 都在此处触发 --><groupid>com.soebes.maven.plugins</groupid><artifactid>echo-maven-plugin</artifactid><executions><execution><id>echo-before</id><phase>compile</phase>...</execution><execution><id>echo-after</id><phase>compile</phase>...</execution></executions></plugin><plugin><!-- antrun plugin: 在 echo plugin 完全执行完后才启动 --><groupid>org.apache.maven.plugins</groupid><artifactid>maven-antrun-plugin</artifactid><executions>...</executions></plugin></plugins>
✅ 正确解法：利用生命周期阶段的天然顺序（推荐）
最稳定、可移植、符合 Maven 设计哲学的方式是：将“前置动作”、“主动作”、“后置动作”分别绑定到逻辑相邻但严格有序的阶段，例如：
| 动作 | 推荐绑定阶段 | 说明 |
|---|---|---|
| Before run plugin antrun. | process-classes | 在 compile 之后、test-compile 之前，确保主代码已编译完成 |
| maven-antrun-plugin:run | compile（或 process-classes） | 保持原有语义，或统一提升至更明确阶段 |
| After run plugin antrun. | test-compile | 在 antrun 执行完毕后立即触发，且天然晚于 compile 阶段 |
✅ 示例配置（无歧义、跨 Maven 版本兼容）：
<build><plugins><!-- Step 1: Before — bound to 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><goals><goal>echo</goal></goals><configuration><echos><echo>[INFO] Before running maven-antrun-plugin.</echo></echos></configuration></execution></executions></plugin><!-- Step 2: Main action — bound to compile (or keep as-is) --><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-antrun-plugin</artifactid><executions><execution><id>run-custom-tasks</id><phase>compile</phase><goals><goal>run</goal></goals><configuration><tasks><echo message="Executing custom Ant tasks..."></echo><!-- your logic here --></tasks></configuration></execution></executions></plugin><!-- Step 3: After — bound to test-compile (guaranteed after compile) --><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>test-compile</phase><goals><goal>echo</goal></goals><configuration><echos><echo>[INFO] After running maven-antrun-plugin.</echo></echos></configuration></execution></executions></plugin></plugins></build>
? 为什么不用
控制？
虽然官方文档提及“同一阶段内多个 execution 按字典序执行”，但该规则仅适用于同一 内部 ；不同之间不共享 排序上下文 ，且 Maven 3.3+ 对跨插件排序未作保证。依赖此方式属于未定义行为（undefined behavior），极易在升级 Maven 或更换构建环境后失效。
⚠️ 补充注意事项
- 避免滥用 pre- / post- 钩子阶段：Maven 并未预定义 pre-compile 或 post-compile 阶段（这些仅存在于 clean 生命周期中），自定义阶段需全局声明，增加复杂度，不推荐。
- maven-surefire-plugin 是特例：它默认绑定到 test 阶段，且设计上要求必须在 compile 和 test-compile 之后、package 之前运行，这印证了阶段顺序的强制性。
- 调试执行顺序：使用 mvn help:effective-pom 查看最终生效的 POM，或 mvn -X compile 开启 debug 日志，搜索 Executing org.apache.maven.plugins:maven-antrun-plugin:run 等关键词定位实际触发点。
✅ 总结
控制 Maven 插件执行顺序的本质，是尊重并利用其生命周期的固有拓扑结构。与其在单一阶段内强行“插队”，不如将关注点转移到选择语义正确、时机可控的相邻阶段。这种做法不仅解决当前问题，更能提升构建脚本的可维护性、可读性与长期稳定性——这正是 Maven “约定优于配置”理念的真正体现。
