本文详解如何在 Maven 构建过程中精确控制多个插件（尤其是同生命周期阶段内）的执行顺序，包括通过 排序、跨阶段解耦、避免重复声明等核心策略，并提供可直接复用的配置示例。

本文详解如何在 maven 构建过程中精确控制多个插件（尤其是同生命周期阶段内）的执行顺序，包括通过 `` 排序、跨阶段解耦、避免重复声明等核心策略，并提供可直接复用的配置示例。

在 Maven 构建流程中，插件（Plugin）是实际执行任务的载体，而生命周期（Lifecycle）和阶段（Phase）则定义了这些任务的执行时序框架。当多个插件被绑定到同一生命周期阶段（如 compile）时，Maven 默认按 的 字典序升序执行——这是实现可控顺序的底层机制，也是解决“前后打印消息”类需求的关键入口。

✅ 正确做法：利用 实现同阶段内插件执行排序

Maven 对同一阶段中多个 的调度规则明确：所有 execution 按其 的字母顺序（ASCII）依次执行。因此，要确保 echo-before → antrun → echo-after 的严格顺序，三者必须属于同一个插件声明块（即不能拆分为两个独立 块），且 必须满足字典序递增：

<build>
  <plugins>
    <!-- 单一插件声明，含三个有序 execution -->
    <plugin>
      <groupId>com.soebes.maven.plugins</groupId>
      <artifactId>echo-maven-plugin</artifactId>
      <version>0.5.0</version>
      <executions>
        <!-- id="a-before" 会最先执行 -->
        <execution>
          <id>a-before</id>
          <phase>compile</phase>
          <goals><goal>echo</goal></goals>
          <configuration>
            <echos><echo>[PRE] Starting maven-antrun-plugin...</echo></echos>
          </configuration>
        </execution>

        <!-- id="b-antrun" 居中执行 -->
        <execution>
          <id>b-antrun</id>
          <phase>compile</phase>
          <goals><goal>run</goal></goals>
          <configuration>
            <tasks>
              <!-- 注意：此处需使用 maven-antrun-plugin 的 goal，但 echo 插件不支持 run goal -->
              <!-- ⚠️ 错误！echo-maven-plugin 没有 run goal → 必须分离插件 -->
            </tasks>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

⚠️ 关键认知纠正：上述写法存在根本性错误——echo-maven-plugin 无法执行 antrun:run。 的 必须属于当前 所声明的插件。因此，不同功能的插件（如 echo 和 antrun）无法通过单个 声明混用 goal。原问题中试图让 echo-maven-plugin 执行 antrun:run 是无效的。

✅ 推荐方案：跨阶段解耦（Robust & Maintainable）

正如答案所指出：“Put the plugins into different life cycle phases. Everything else is just brittle.” —— 将依赖顺序的插件分配到相邻但不同的标准阶段，是最稳定、最符合 Maven 设计哲学的方式。

例如，将“前置日志 → 核心任务 → 后置日志”映射为：

• process-classes 阶段：执行 echo:echo（前置）
• compile 阶段：执行 maven-antrun-plugin:run（主任务）
• process-test-classes 阶段：执行 echo:echo（后置）

但更自然、语义更清晰的选择是使用 compile → test-compile → test 这一连续流（注意：test-compile 在 compile 之后、test 之前）：

<build>
  <plugins>
    <!-- 1. 前置提示：绑定到 compile 阶段 -->
    <plugin>
      <groupId>com.soebes.maven.plugins</groupId>
      <artifactId>echo-maven-plugin</artifactId>
      <version>0.5.0</version>
      <executions>
        <execution>
          <id>pre-antrun</id>
          <phase>compile</phase>
          <goals><goal>echo</goal></goals>
          <configuration>
            <echos><echo>✅ Entering ANTRUN execution phase...</echo></echos>
          </configuration>
        </execution>
      </executions>
    </plugin>

    <!-- 2. 主任务：绑定到 test-compile 阶段（紧随 compile 之后） -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-antrun-plugin</artifactId>
      <executions>
        <execution>
          <id>run-custom-tasks</id>
          <phase>test-compile</phase>
          <goals><goal>run</goal></goals>
          <configuration>
            <tasks>
              <echo message="? Running custom ANT logic..." />
              <!-- your ant tasks here -->
            </tasks>
          </configuration>
        </execution>
      </executions>
    </plugin>

    <!-- 3. 后置提示：绑定到 test 阶段（紧随 test-compile 之后） -->
    <plugin>
      <groupId>com.soebes.maven.plugins</groupId>
      <artifactId>echo-maven-plugin</artifactId>
      <version>0.5.0</version>
      <executions>
        <execution>
          <id>post-antrun</id>
          <phase>test</phase>
          <goals><goal>echo</goal></goals>
          <configuration>
            <echos><echo>? ANTRUN completed successfully.</echo></echos>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

✅ 优势：

• 完全规避 排序的脆弱性（如 ID 拼写错误、版本升级导致排序逻辑变化）；
• 符合 Maven 生命周期语义，便于团队理解与维护；
• 不受插件是否允许多 execution 的限制；
• 可天然支持跳过某阶段（如 -Dmaven.test.skip=true 会跳过 test 阶段及其绑定插件）。

⚠️ 注意事项与常见误区

• 禁止重复声明同一插件：如问题中首次尝试那样将 echo-maven-plugin 写两次，Maven 会报错 Plugin 'com.soebes.maven.plugins:echo-maven-plugin' has duplicate declaration。务必合并为单个 块。
• 必须是合法生命周期阶段：拼写错误（如 complie）会导致插件不执行且无提示；建议使用 IDE 的 pom.xml 自动补全或参考 Maven 官方生命周期文档。
• maven-surefire-plugin 等默认绑定插件不可随意挪动阶段：除非有强理由（如集成测试隔离），否则应保持其默认绑定（test 阶段），避免破坏构建契约。
• 调试执行顺序：运行 mvn help:effective-pom -Dverbose 可查看最终生效的插件绑定关系；mvn -X compile 启用 debug 日志，观察插件实际触发顺序。

✅ 总结

控制 Maven 插件执行顺序的本质，是理解并尊重其生命周期模型。同一阶段内靠 排序仅适用于同一插件的多个 execution；而涉及多个不同插件的协同顺序，应优先采用跨阶段绑定这一健壮模式。它不仅解决了“前后打印”的具体问题，更体现了对 Maven “约定优于配置”理念的深度践行——让构建流程清晰、可预测、易演进。