Java工具篇之Maven:从pom.xml到测试通过的JAR

作者:code2cat日期:2026/11/5

昨天的Spring Boot项目用一条命令就能编译、测试和打包。今天把这条命令拆开:Maven依据pom.xml组织构建,并由插件执行具体工作。理解这层分工,才能看懂“IDE里能运行,命令行却失败”究竟是哪一步出了问题。

本文用Maven3.9.9、JDK21和一个完整的小项目讲清坐标、目录、依赖、生命周期、插件与排错。我们让测试真正守住打包入口,再观察产物里到底有什么。

一、先认识项目的三个坐标

一个制品通常用groupId、artifactId、version识别。例如demo:build-lab:1.0.0中,demo是组织命名空间,build-lab是制品名,1.0.0是版本。默认packaging是jar;它决定默认绑定哪些构建任务。

POM并非只是一张下载清单。它同时描述项目身份、依赖和构建配置。dependencies供项目代码使用,build/plugins参与构建过程。JUnit是测试依赖;编译器插件负责调用编译器,Surefire插件运行单元测试,JAR插件打包。

二、建立一个可验证的最小项目

目录如下,测试文件名称以Test结尾,能被本例Surefire默认规则发现:

1build-lab/
2├─ pom.xml
3└─ src/
4   ├─ main/java/demo/App.java
5   └─ test/java/demo/AppTest.java
6

完整pom.xml:

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">
2  <modelVersion>4.0.0</modelVersion>
3  <groupId>demo</groupId><artifactId>build-lab</artifactId><version>1.0.0</version>
4  <properties>
5    <maven.compiler.release>21</maven.compiler.release>
6    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
7  </properties>
8  <dependencies>
9    <dependency>
10      <groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter</artifactId>
11      <version>5.11.4</version><scope>test</scope>
12    </dependency>
13  </dependencies>
14  <build><plugins>
15    <plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.13.0</version></plugin>
16    <plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId><version>3.5.2</version></plugin>
17    <plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-jar-plugin</artifactId><version>3.4.2</version>
18      <configuration><archive><manifest><mainClass>demo.App</mainClass></manifest></archive></configuration>
19    </plugin>
20  </plugins></build>
21</project>
22

release设为21,要求编译环境支持该目标,并约束使用的Java平台API。它不负责替你安装JDK。先运行mvn -v,检查Maven实际使用的Java版本与Java home;IDE项目SDK和终端JAVA_HOME可能不同。

显式固定插件版本,使团队采用相同的插件行为。JUnit只在测试阶段需要,所以配置test作用域。主程序不依赖它,运行时也不需要携带它。

App.java:

1package demo;
2
3public class App {
4    public static String label(String title) {
5        if (title == null || title.isBlank()) {
6            throw new IllegalArgumentException("title is blank");
7        }
8        return "TODO: " + title.strip();
9    }
10    public static void main(String[] args) {
11        System.out.println(label(args.length == 0 ? "learn Maven" : args[0]));
12    }
13}
14

AppTest.java:

1package demo;
2
3import org.junit.jupiter.api.Test;
4import static org.junit.jupiter.api.Assertions.*;
5
6class AppTest {
7    @Test void trimsTitle() {
8        assertEquals("TODO: learn Maven", App.label("  learn Maven  "));
9    }
10    @Test void rejectsBlank() {
11        assertThrows(IllegalArgumentException.class, () -> App.label("  "));
12    }
13    @Test void rejectsNull() {
14        assertThrows(IllegalArgumentException.class, () -> App.label(null));
15    }
16}
17

测试覆盖正常标题、空白和null三条路径。这个例子虽小,失败条件却明确:如果以后删除输入检查,测试应当阻止构建继续成功。

三、阶段与目标如何配合

运行mvn verify时,Maven沿default生命周期执行到verify;不是只执行一个叫verify的动作。主要阶段可以这样读:

阶段关心的结果
compile主源码编译成功
test单元测试通过
package生成JAR等制品
verify执行已绑定的后续质量检查
install把制品放入本地仓库,供其他本地项目引用
deploy将制品发布到远程制品仓库

阶段规定顺序,插件目标负责动作。 例如compiler:compile执行编译,surefire:test执行测试。直接调用插件目标不等于自动执行它之前的全部生命周期阶段。verify是否执行集成测试或静态检查,取决于项目是否配置了对应插件和绑定,阶段名称本身不会自动生成这些检查。生命周期说明

clean属于另一条生命周期。mvn clean verify先清理再构建;单独mvn verify不会自动清空旧产物。日常增量构建可以不clean,排除遗留文件或做交付验收时使用clean更直接。

四、运行、检查产物,再故意让测试失败

在pom.xml所在目录执行:

1mvn -v
2mvn clean verify
3java -jar target/build-lab-1.0.0.jar
4jar tf target/build-lab-1.0.0.jar
5

本次实际验收:3个测试全部通过,JAR启动输出TODO: learn Maven;故意改错断言后构建失败且未生成JAR,恢复后重新构建成功。JAR目录中包含App.class,不包含测试类和JUnit。

本例构建通过后,测试报告在target/surefire-reports,主类在target/classes,JAR在target/build-lab-1.0.0.jar。我们配置Main-Class清单,因此可以用java -jar启动。

普通JAR插件不会自动把所有第三方依赖打进JAR。这里主程序只用JDK,所以能独立运行。若加入运行时库,需要明确classpath、分发依赖,或选择适合项目的打包插件;Spring Boot可执行包也有自己的打包方式。

将测试期望临时改为错误字符串,再执行mvn clean verify:测试阶段失败,命令返回非零退出码,后续打包不会执行。恢复期望后再次构建。通过一次可控失败,可以确认CI执行的确实是测试,而非只编译源码或跳过测试。

不要把跳过测试当作修复。 -DskipTests通常跳过测试执行但仍编译测试代码;maven.test.skip会被相关插件用于跳过测试编译和执行。交付流水线应保留真实验收步骤。

五、依赖怎样进入classpath

作用域主要用途
compile默认值,主编译与运行都需要
provided编译需要,运行环境提供
runtime主编译不需要,运行需要
test测试编译和执行需要

传递依赖把依赖的依赖带进解析图,实际传播还受作用域、optional和exclusions影响。同一个库出现多个版本时,Maven通常选择依赖路径更近的定义;同深度时先声明者优先。不要把“声明过一个新版本”理解为依赖图里所有关联库都自动升级。依赖机制

用依赖树找来源,比直接往pom.xml反复加版本更有效:

1mvn dependency:tree
2mvn help:effective-pom
3

dependencyManagement集中管理依赖版本和相关属性,本身不等于引入依赖。子项目仍在dependencies声明需要的库。pluginManagement也用于管理插件配置,是否执行仍要看插件实际声明和生命周期绑定;不要把管理区当作执行清单。

六、仓库、重复构建与排错顺序

本地仓库存放已下载依赖和本地install产物,远程仓库提供可下载制品。install成功只说明当前机器的其他项目可以解析这个版本;让同事和CI使用,应通过团队远程制品仓库发布,不能依靠复制个人仓库目录。

项目配置提交到版本库,仓库凭据放在受控的settings.xml或CI凭据系统中。固定依赖与插件版本、使用Maven Wrapper统一Maven版本,再统一JDK环境,才能减少“同一份代码,不同机器构建不同”的情况。SNAPSHOT内容可以变化,缓存与更新策略也会影响解析结果。

遇到失败按日志定位:先看mvn -v确认环境,再看第一个失败插件;编译错误查源码与release,测试错误查surefire-reports,解析失败查坐标、网络和仓库配置。只有明确是某个缓存制品损坏,才针对它处理;删除整个本地仓库会造成大量无关重新下载。

七、🧠 思维导图

Maven构建

POM与坐标

生命周期

依赖

验收

项目与插件配置

compile test package verify

install与deploy

作用域与版本仲裁

测试失败阻止打包

依赖树与有效POM

八、总结

总结要点

POM把构建要求写成共享约定。 坐标说明项目是谁,依赖说明代码需要什么,插件说明构建如何执行。

生命周期让步骤有序衔接。 选择需要到达的阶段,让测试与检查成为产物生成的前置条件,再用一次失败实验验证它们真的生效。

排错要看实际环境和解析结果。 mvn -v、依赖树、有效POM和测试报告,比反复点IDE重试更能解释问题。

下一篇继续工具篇,使用Gradle重建同一个小项目,对比任务图、依赖配置与Wrapper。

👉 如果你觉得这篇文章对你有所帮助,欢迎点赞、收藏、分享!😊


《Java工具篇之Maven:从pom.xml到测试通过的JAR》 是转载文章,点击查看原文。


相关推荐


HTTP2Shell 漏洞 CVE-2026-111497:5 分钟排查 Node.js/Python/Bun/Envoy 是否受影响
王亚博_Abel2026/10/28

HTTP2Shell 漏洞 CVE-2026-111497:5 分钟排查 Node.js/Python/Bun/Envoy 是否受影响 10 月 21 日,Node.js 项目发布安全更新,修复了一个 Brotli 解码器中的严重内存安全漏洞。这个漏洞(CVE-2026-111497,CVSS 9.2)的影响范围远超 Node.js:Python 的 brotli/brotlicffi 包、Bun、Envoy 代理、Istio 服务网格,以及任何内嵌受影响 Brotli 解码器的 HTTP 客户


【大模型应用开发:基于GPT-4和ChatGPT】(深入了解GPT-4和ChatGPT的API)
承渊政道2026/10/20

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */ #content_views .toc, /* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */ #content_views.markdown_views > p:empty:has(+ .toc), #content_views.markdown_views > .toc + p:emp


第27课:SkyWalking全链路追踪实战 & 微服务调用链路分析
Thomas.Sir2026/10/17

文章目录 一、开篇:第26课留下的“盲区”二、分布式追踪理论基础2.1 Dapper论文的核心思想2.2 三大核心概念:Trace、Segment、Span2.3 上下文传播:跨服务追踪的核心 三、SkyWalking架构深度剖析3.1 四层架构:Probe → OAP → Storage → UI3.2 核心数据模型3.3 Java Agent的字节码增强原理 四、SkyWalking部署实战4.1 Docker Quick Start部署4.2 验证部署 五、Java A


A股量化数据工程:从 REST 接口到策略信号(第 17 篇):创新高与新低扫描
泡茶喝茶写代码2026/10/10

A股量化数据工程:从 REST 接口到策略信号(第 17 篇):创新高与新低扫描 前言 创新高 / 新低是个股强度最直观的信号:持续新高说明趋势强,密集新低说明杀跌未止。接口 himk/pzxg(盘中创新高)、himk/pzxd(盘中创新低)直接给出标的与「是否创新高」标记,本篇自研新高强度扫描器,把个股强度汇总成市场温度计。 一、接口原始字段梳理 1)盘中创新高个股 接口地址:https://api.biyingapi.com/himk/pzxg/{LICENCE} 字段说明t日期dm股票代


2026 年 AI Agent 面试到底考什么?这套题库覆盖了 90% 的高频考点
怕浪猫2026/10/2

第一章:Agent 基础概念与架构 1.1 什么是 AI Agent:从概念定义到本质特征 AI Agent 是当前大模型应用领域最受关注的技术范式。要准确理解它,需要回到这个概念的本质。 斯坦福大学教授 Yoav Shoham 在 1993 年的经典论文中给出了一个被广泛引用的定义:Agent 是能够感知环境、自主行动并对其行为负责的计算实体。这个定义虽然朴素,但奠定了后续几十年 Agent 研究的基本框架。 进入大模型时代后,Lilian Weng 在 “LLM Powered Autono


聚合边界:为什么 ProcessTask 没有自己的 Repository
mldong2026/9/26

上一篇(DDD 系列 ①)我用两笔账回答了"贫血和充血差在哪"。后台收到一个很合理的质疑,今天专门回答它: "你说流程任务不能自己改状态,可我翻了你引擎的仓储接口,里面明明就有 saveTask 和 updateTask——这不是自己打脸吗?任务要真没有仓储,这两个方法是哪来的?" 问得好。这篇文章就把这句话掰开:仓储的数量为什么跟着聚合走,而不是跟着表走、跟着类走;以及,如果把 ProcessTask 拆成一个独立聚合、给它配一个独立的仓储,半状态是从哪扇门进来的。 一、先看三个必须"同时


PHP 8.6 只是个小版本,三十项弃用却已在为 PHP 9.0 铺路
BingoGo2026/9/18

PHP 8.6 只是个小版本,三十项弃用却已在为 PHP 9.0 铺路 部分函数应用、Time\Duration,以及一份实质上是为 PHP 9.0 做准备的弃用清单 本文基于 PHP 8.6 beta 3 撰写。特性集已经冻结;若正式版(GA)之前出现变动,文中会予以说明。 PHP 8.6 将于 2026 年 11 月 19 日发布,其变更规模比 8.5 更小。没有 JIT,没有属性钩子(property hooks),没有联合类型——没有任何会重塑类编写方式的改动。 因此,先给出坦率的结论:


【Windows】《深入浅出Windows API程序设计:编程基础篇》笔记-Chapter10-通用对话框
江湖人称菠萝包2026/9/9

第10章 通用对话框 通用对话框库包含一组用于执行常见应用程序任务的对话框,例如打开文件、选择颜色和打印文档等,通用对话框实现了应用程序用户界面的一致性,例如单击不同程序的文件菜单下的打开文件子菜单项,通常都会弹出相同的打开文件对话框。要弹出打开文件、选择颜色和打印文档等通用对话框用的是不同的函数,在使用这些函数时,基本上都要初始化一个结构的一些字段并将该结构的指针传递给这些函数。函数会创建并显示相应的对话框,当用户关闭对话框时,函数将控制权返还给程序,然后程序可以从先前传递给函数的结构中获取需


从零创建一个 Django 项目
2601_962065252026/9/1

1. 准备环境在开始之前,确保你的开发环境满足以下要求:* 安装了 Python (推荐 3.8 或更高版本)。* 安装 pip 包管理工具。* 如果要使用 MySQL 或 PostgreSQL,确保对应的数据库已安装。#### 创建虚拟环境在项目目录中创建并激活虚拟环境,保证项目依赖隔离: # 创建虚拟环境 python -m venv env # 激活虚拟环境 # Windows envScriptsactivate # Linux/Mac source env/bin/activate *


算法二叉树(一)
纪念 2292026/8/24

༺ 个人主页 · 纪念229 ༻ 🏠我的博客主页🏠 ༒专栏目录:《数据结构》༒ ༒专栏目录:《算法》༒ ༒专栏目录:《MySQL数据库》༒ ༒专栏目录:《前端开发》༒ ༒其它有趣的计算机知识༒ ༺世上本没有路,走的人多了自然就有了༻ 本节讲的是有关二叉树的OJ题,希望对你有所帮助 题目链接 二叉树前序遍历 二叉树中序遍历 二叉树的后序遍历 单值二叉树 对称二叉树 文章目录 1.二叉树前序遍历2.单值二叉树3.对称二叉树 文章开始前我与大家讨论一

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读