构建与依赖 / 系统课时
默认生命周期绑定
默认生命周期绑定
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 项目观察自动绑定
创建空目录,在根目录保存下面的 pom.xml。这里没有显式声明 Resources、Compiler、Surefire 或 JAR 插件的执行阶段,因此后续日志里出现的这些目标主要来自 jar 打包类型的默认生命周期绑定。
<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:
package demo;
public class App {
public static void main(String[] args) {
System.out.println("lifecycle-demo");
}
}在项目根目录执行:
mvn package预期输出
[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> 上下文:
<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。如果目标是改变默认打包行为,应先确认是要调整插件配置、替换插件版本,还是新增执行;仅仅再绑一次同类目标很容易造成重复执行。