本文系统讲解 Maven 中插件在相同生命周期阶段内的执行顺序控制机制，涵盖 execution id 字母序规则、跨阶段拆分策略、常见误区与最佳实践，助你可靠实现“前置打印→主插件执行→后置打印”等精确编排需求。
本文系统讲解 maven 中插件在相同生命周期阶段内的执行顺序控制机制，涵盖 `execution id` 字母序规则、跨阶段拆分策略、常见误区与最佳实践，助你可靠实现“前置打印→主插件执行→后置打印”等精确编排需求。
在 Maven 构建过程中，插件并非按 <plugins> 标签中声明的物理顺序执行，而是严格依据其绑定的生命周期阶段（phase）及内部执行配置（<execution>）进行调度。当你希望在 maven-antrun-plugin 执行前后分别输出日志（如 “Before run plugin antrun.” 和 “After run plugin antrun.”），仅将多个 <execution> 声明在同一插件内或简单调整 <plugin> 顺序是无效的——因为 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..." />
<!-- 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 将自动触发：
- process-classes 阶段 → 输出 “Before”
- compile 阶段 → 运行 Ant 任务
- prepare-package 阶段 → 输出 “After”
全程无需 hack，完全遵循 Maven 设计规范，具备强可移植性与可维护性。
⚠️ 注意事项与常见误区
❌ 错误认知：“声明顺序 = 执行顺序”
<plugin> 在 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 在 <plugins> 中唯一）。正确做法是单次声明插件，通过多个 <execution> 定义不同行为（如第二版尝试），但需配合阶段分离才能保证时序。? 验证执行顺序的小技巧
运行 mvn help:effective-pom -Dverbose 可查看 Maven 实际解析后的完整执行计划（<executions> 列表及其绑定 phase），是调试插件顺序的权威依据。
总结
控制 Maven 插件执行顺序的本质，是理解并尊重其生命周期模型。与其在单一 phase 内“争抢执行权”，不如善用阶段间的天然依赖关系，将关注点解耦到语义明确的相邻阶段中。这不仅解决了日志前后置问题，更提升了构建脚本的健壮性、可读性与团队协作效率。记住口诀：“阶段定序，ID 微调；跨阶段拆分，才是正解。”
