构建与依赖 / 系统课时
JAR、WAR 与 POM 打包类型
JAR、WAR 与 POM 打包类型
packaging 不只是决定文件后缀,它还决定 Maven 默认生命周期在各阶段绑定哪些插件目标。本篇用同一个项目对比 jar、war、pom,并给出可直接执行的打包与制品检查方法。
学习目标
- 能根据库、Web 应用和父工程场景选择
jar、war或pom - 能说明三种 packaging 在
package阶段的默认行为差异 - 能用 Maven 命令验证当前 packaging 和实际产物
packaging 会改变默认生命周期绑定
以下结论适用于 Maven 3.9+ 的常规项目;具体默认插件版本由 Maven 发行版决定。未声明 <packaging> 时,Maven 默认按 jar 处理。
| packaging | 常见用途 | package 阶段默认目标 |
典型制品 |
|---|---|---|---|
jar |
Java 类库、普通 Java 程序 | maven-jar-plugin:jar |
target/<artifactId>-<version>.jar |
war |
部署到 Servlet 容器的 Web 应用 | maven-war-plugin:war |
target/<artifactId>-<version>.war |
pom |
父 POM、聚合多模块工程 | 不默认生成 JAR/WAR 二进制包 | POM 本身可被 install、deploy |
jar 与 war 在资源处理、编译、测试等阶段有相近的默认绑定,但到了 package 阶段会调用不同的打包插件。pom 更适合承载 dependencyManagement、pluginManagement 和 <modules>,不要把它当成“没有后缀的 JAR”。
用一个最小项目验证默认 jar
创建 pom.xml,故意不写 <packaging>,让 Maven 使用默认值 jar。为避免不同 Maven 发行版带来的 JAR Plugin 版本差异,示例显式固定 3.5.1。
<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>com.example</groupId>
<artifactId>packaging-demo</artifactId>
<version>1.0.0</version>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.5.1</version>
</plugin>
</plugins>
</build>
</project>先读取 Maven 实际解析出的 packaging:
mvn -q help:evaluate -Dexpression=project.packaging -DforceStdout预期输出:
jar再执行打包,并用 Shell 检查目标文件是否生成。下面命令适用于 Linux、macOS 或 Git Bash。
mvn -q clean package && test -f target/packaging-demo-1.0.0.jar && echo "artifact=target/packaging-demo-1.0.0.jar"预期输出:
artifact=target/packaging-demo-1.0.0.jar切换为 war 或 pom 时看什么
需要 WAR 时,只需在现有 POM 的项目坐标附近加入 packaging。片段示例依赖前面的完整 pom.xml:
<packaging>war</packaging>为避免 Maven 自带默认插件版本差异,实际项目还应在 <build><plugins> 中显式固定 maven-war-plugin,例如 3.5.1。执行 mvn package 后检查 target/packaging-demo-1.0.0.war;真正的 Web 项目还应按所用 Jakarta Servlet 技术栈提供 Web 资源和依赖。
父工程或聚合工程通常使用:
<packaging>pom</packaging>此时 mvn package 不会像 jar、war 那样默认产生应用二进制包,但 mvn install 仍会把该项目的 POM 安装到本地仓库,供子模块或其他项目继承和引用。
选择类型时避免三个常见误判
Java 类库、普通命令行程序优先选 jar;需要传统 Servlet 容器部署的 Web 应用选 war;只负责父配置或聚合模块时选 pom。如果模块既要聚合其他模块又要编译自己的 Java 代码,应拆成父模块与业务模块,而不是把业务模块强行设为 pom。
判断是否选对类型,可以固定检查三件事:mvn help:evaluate 返回的 packaging、mvn package 后 target 中的主制品、以及 mvn install 后本地仓库中的坐标。三者一致时,生命周期绑定和发布制品才没有偏差。