jenkins java项目构建失败的三大核心卡点是mvn环境缺失、java_home路径错配和构建触发逻辑不当；需在global tool configuration中配置maven与jdk，通过which mvn和mvn -v验证实际调用路径，显式选择jdk而非硬编码路径，并确保surefire插件启用及测试类命名规范。
Jenkins 在 Java 项目里不是配好了就能跑通的，核心卡点往往在 mvn 环境、JAVA_HOME 路径和构建触发逻辑这三处。
Java 项目构建失败：找不到 mvn 或报 Command 'mvn' not found
Jenkins 默认不自带 Maven，哪怕你本地装了，Jenkins 的 agent 进程也看不到。它用的是独立的环境变量空间。
- 进 Jenkins →
Manage Jenkins→Global Tool Configuration，在Maven区域点Add Maven，选Install automatically（推荐）或指定已安装路径 - 不要在 shell 构建步骤里写
mvn clean package就完事——得确认 Jenkins 实际调用的是哪个mvn，可在构建前加一行which mvn或mvn -v打印验证 - 如果用的是 Windows agent，注意路径分隔符和
mvn.cmd后缀；Linux/macOS 下必须确保mvn可执行位已设（chmod +x）
Jenkins 报 java.lang.UnsupportedClassVersionError
这是 JDK 版本错配最典型的信号：代码用 JDK 17 编译，但 Jenkins agent 只装了 JDK 8，或者反过来。
- 检查项目
pom.xml中的maven-compiler-plugin配置，比如<source>17</source>和<target>17</target>必须与 Jenkins 实际运行的 JDK 一致 - 在
Global Tool Configuration里配置好 JDK（别只装不勾选），并在 job 配置页的General→Restrict where this project can be run下确认 agent 节点已安装对应 JDK - 避免在构建脚本里硬写
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk——Jenkins 会覆盖它；正确做法是在 job 配置中显式选择 JDK 名称（下拉框）
构建成功但测试不运行，或 surefire 插件静默跳过
Maven 默认跳过测试是常态，尤其当项目没写测试类、或 test 目录结构不对时，mvn verify 也不会报错，容易误以为“通过”。
立即学习“Java免费学习笔记（深入）”；
- 确认测试类命名符合约定：
*Test.java、Test*.java或*Tests.java；JUnit 5 还需检查是否引入了junit-jupiter-engine - 在
pom.xml中显式启用 surefire：<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-surefire-plugin</artifactid><version>3.0.0-M9</version></plugin> - Jenkins 构建命令别只写
mvn compile，至少用mvn verify；若想强制跑测试，加参数-Dmaven.test.skip=false（注意不是skipTests）
真正麻烦的从来不是“怎么点按钮”，而是 Jenkins 的每个 agent 都像一个独立小系统，JAVA_HOME、PATH、Maven 版本、甚至 shell 类型（sh vs bash）都可能差一点就让 mvn clean install 表面成功、实际漏掉测试或打包错 class 文件。
