构建与依赖 / 系统课时

默认生命周期绑定

默认生命周期绑定

Maven 的 default 生命周期只定义阶段顺序,真正执行什么由打包类型的默认绑定决定。本课用 jar、war、pom 对比同一阶段触发的插件目标,并用最小项目验证为什么只写一个 packaging 也能完成编译、测试和打包。

学习目标

  • 说清 packaging、生命周期阶段与插件目标三者的关系。
  • 对比 jar、war、pom 在默认生命周期中的关键绑定。
  • 能从构建日志判断某个目标是默认绑定还是显式配置触发的。

打包类型决定哪些目标自动执行

default 生命周期提供 compile、test、package、install、deploy 等阶段,但阶段本身不是插件任务。Maven 根据 <packaging> 选择默认绑定;未声明 <packaging> 时按 jar 处理。下面只列最常用、最能看出差异的绑定。

阶段 jar war pom
compile compiler:compile compiler:compile 无默认目标
test surefire:test surefire:test 无默认目标
package jar:jar war:war 无默认目标
install install:install install:install install:install
deploy deploy:deploy deploy:deploy deploy:deploy

jar 与 war 在资源处理、编译和单元测试阶段基本一致,差异集中在 package:前者生成 JAR,后者调用 WAR 插件生成 WAR。pom 常用于父工程或聚合工程,因此默认不会在 compile、test、package 阶段生成二进制包。

jar、war 与 pom 的默认生命周期绑定关系

用最小 jar 项目观察自动绑定

创建空目录,在根目录保存下面的 pom.xml。这里没有显式声明 Resources、Compiler、Surefire 或 JAR 插件的执行阶段,因此后续日志里出现的这些目标主要来自 jar 打包类型的默认生命周期绑定。

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>demo</groupId>
  <artifactId>lifecycle-demo</artifactId>
  <version>1.0.0</version>
  <packaging>jar</packaging>

  <properties>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
  </properties>
</project>

再创建 src/main/java/demo/App.java:

java
package demo;

public class App {
    public static void main(String[] args) {
        System.out.println("lifecycle-demo");
    }
}

在项目根目录执行:

bash
mvn package

预期输出

text
[INFO] --- maven-resources-plugin:<VERSION>:resources (...) @ lifecycle-demo ---
[INFO] --- maven-compiler-plugin:<VERSION>:compile (...) @ lifecycle-demo ---
[INFO] --- maven-resources-plugin:<VERSION>:testResources (...) @ lifecycle-demo ---
[INFO] --- maven-compiler-plugin:<VERSION>:testCompile (...) @ lifecycle-demo ---
[INFO] --- maven-surefire-plugin:<VERSION>:test (...) @ lifecycle-demo ---
[INFO] --- maven-jar-plugin:<VERSION>:jar (...) @ lifecycle-demo ---
[INFO] BUILD SUCCESS

<VERSION> 会随 Maven 版本、父 POM 或 pluginManagement 而变化;需要观察的是目标名称与执行顺序。执行到 package 时,Maven 会按阶段顺序把之前阶段的默认绑定一并执行,而不是只调用 jar:jar。

阶段调用和目标调用不要混用

构建命令左侧如果是生命周期阶段,Maven 会先执行该阶段之前的所有阶段;如果直接写 插件前缀:目标,则只调用那个插件目标,不会自动补跑生命周期。下面的对比可用于排查“为什么直接调用插件后缺少编译产物”。

调用方式 会自动执行前置阶段 典型用途
mvn package 会,从 validate 一直到 package 正常生成可发布构件
mvn install 会,一直到 install 同时写入本地仓库
直接调用 jar:jar 不会 调试单个插件目标,不应替代常规构建

因此,项目交付脚本应优先调用阶段,例如 package、verify 或 install。直接调用目标适合诊断插件行为,但它绕开阶段链路后,编译、测试、资源处理是否已经发生要由调用者自己保证。

自定义绑定是在默认绑定上追加

在 <build><plugins> 中把另一个目标绑定到某个阶段,通常是给该阶段增加执行,而不是自动替换原来的默认绑定。例如把 maven-antrun-plugin 的 run 目标绑到 package,jar 项目仍会执行默认的 jar:jar,随后还会执行你新增的目标,具体顺序受绑定来源和声明顺序影响。

下面是片段示例,依赖现有 Maven 项目的 <build> 上下文:

xml
<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-antrun-plugin</artifactId>
  <version>3.1.0</version>
  <executions>
    <execution>
      <id>mark-package</id>
      <phase>package</phase>
      <goals>
        <goal>run</goal>
      </goals>
      <configuration>
        <target>
          <echo message="package phase reached"/>
        </target>
      </configuration>
    </execution>
  </executions>
</plugin>

生效后运行 package 阶段时,会保留 jar 打包的默认 jar:jar,并额外执行 antrun:run。如果目标是改变默认打包行为,应先确认是要调整插件配置、替换插件版本,还是新增执行;仅仅再绑一次同类目标很容易造成重复执行。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

默认生命周期绑定

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通