本文系统讲解 Maven 中插件在相同生命周期阶段内的执行顺序控制机制，涵盖 execution id 字母序规则、跨阶段拆分策略、常见误区与最佳实践，助你可靠实现“前置打印→主插件执行→后置打印”等精确编排需求。

本文系统讲解 maven 中插件在相同生命周期阶段内的执行顺序控制机制，涵盖 `execution id` 字母序规则、跨阶段拆分策略、常见误区与最佳实践，助你可靠实现“前置打印→主插件执行→后置打印”等精确编排需求。

在 Maven 构建过程中，插件并非按 标签中声明的物理顺序执行，而是严格依据其绑定的生命周期阶段（phase）及内部执行配置（）进行调度。当你希望在 maven-antrun-plugin 执行前后分别输出日志（如 “Before run plugin antrun.” 和 “After run plugin antrun.”），仅将多个 声明在同一插件内或简单调整 顺序是无效的——因为 Maven 对同一 phase 内所有插件的 execution 是统一收集、按 id 字典序排序后批量执行的，而非“插件A执行完再执行插件B”。

✅ 正确方案：利用 Maven 生命周期的阶段依赖性（推荐）

Maven 的 default 生命周期是严格线性的，且后续阶段天然依赖前一阶段完成。因此，最稳定、最符合设计哲学的方式是将前置、主逻辑、后置操作分别绑定到三个连续且有依赖关系的阶段，例如：

• process-classes → 打印“Before”
• compile（或 test-compile）→ 执行 maven-antrun-plugin
• prepare-package → 打印“After”

? 为什么选 prepare-package？它紧接在 compile 之后、package 之前，是专为“打包前准备”设计的标准阶段，语义清晰、无副作用。

对应配置如下（精简可运行示例）：

<build><plugins><!-- Step 1: Before — 绑定到 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 — 绑定到 compile 阶段（或更合适的阶段） --><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-antrun-plugin</artifactid><version>3.1.0</version><executions><execution><id>run-custom-tasks</id><phase>compile</phase><goals><goal>run</goal></goals><configuration><tasks><echo message="Executing custom Ant logic..."></echo><!-- your real tasks here --></tasks></configuration></execution></executions></plugin><!-- Step 3: After — 绑定到 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><goals><goal>echo</goal></goals><configuration><echos><echo>[INFO] ✅ After running maven-antrun-plugin</echo></echos></configuration></execution></executions></plugin></plugins></build>

✅ 执行 mvn compile 时，Maven 将自动触发：

1. process-classes 阶段 → 输出 “Before”
2. compile 阶段 → 运行 Ant 任务
3. prepare-package 阶段 → 输出 “After”

全程无需 hack，完全遵循 Maven 设计规范，具备强可移植性与可维护性。

⚠️ 注意事项与常见误区

• ❌ 错误认知：“声明顺序 = 执行顺序”
  在 POM 中的书写顺序不影响执行时序；Maven 解析后会统一归并所有 execution 并按 phase + id 排序。

• ⚠️ id 字典序仅用于同 phase 内多 execution 的微调
  若必须共存于同一 phase（如都绑定 compile），则 id="a-before" 一定早于 id="z-after"。但此方式不可靠：一旦其他插件也绑定该 phase 且 id 介入（如 maven-compiler-plugin 默认 id="default-compile"），顺序即失控。不推荐作为核心逻辑依赖。

• ✅ 避免重复声明同一插件多次
  如问题中首次尝试那样多次声明 echo-maven-plugin 会导致 POM 解析失败（Maven 要求同一 groupId:artifactId 在 中唯一）。正确做法是单次声明插件，通过多个 定义不同行为（如第二版尝试），但需配合阶段分离才能保证时序。

• ? 验证执行顺序的小技巧
  运行 mvn help:effective-pom -Dverbose 可查看 Maven 实际解析后的完整执行计划（ 列表及其绑定 phase），是调试插件顺序的权威依据。

总结

控制 Maven 插件执行顺序的本质，是理解并尊重其生命周期模型。与其在单一 phase 内“争抢执行权”，不如善用阶段间的天然依赖关系，将关注点解耦到语义明确的相邻阶段中。这不仅解决了日志前后置问题，更提升了构建脚本的健壮性、可读性与团队协作效率。记住口诀：“阶段定序，ID 微调；跨阶段拆分，才是正解。”