Jenkins配置Java环境变量需三层落实：系统级（设置JAVA_HOME和PATH）、Jenkins全局工具级（在Global Tool Configuration中注册JDK名称与路径）、流水线运行时级（通过tools指令或tool函数调用指定JDK），缺一可能导致java命令未找到或版本错误。
在 Jenkins 中配置 Java 环境变量，核心是让 Jenkins 构建任务能正确识别并使用指定 JDK。这不是只设一个 JAVA_HOME 就完事，而是分三层落实：系统级、Jenkins 全局工具级、流水线运行时级。漏掉任一层，都可能在构建时报 java: command not found 或版本不匹配。
先确认 JDK 已装好且路径明确
登录 Jenkins 所在服务器（Master 或 Agent），执行：
java -version which java readlink -f $(which java)
输出应显示版本号，并最终指向 $JDK_HOME/bin/java。常见路径示例：
- Linux：/usr/lib/jvm/java-11-openjdk-amd64 或 /opt/java/jdk-17.0.2
- macOS：/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
- Windows：C:\Program Files\Java\jdk-17.0.2
记下这个完整路径，后续所有配置都基于它。
立即学习“Java免费学习笔记（深入）”；
在 Jenkins 全局工具中注册 JDK
这是最关键的一步，Jenkins 不会自动读取系统 JAVA_HOME，必须显式声明。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 进入 Manage Jenkins → Global Tool Configuration
- 找到 JDK 区域，点击 Add JDK
- 取消勾选 Install automatically
- 填写 Name（如
jdk-17，后续流水线里就用这个名字） - 在 JAVA_HOME 栏粘贴你刚才确认的完整路径（不要加
/bin） - 点击 Save
保存后，该 JDK 名称就会出现在所有 Pipeline 的 tools 指令或项目配置的 JDK 下拉菜单中。
在流水线中声明并使用 JDK
仅注册还不够，必须在每次构建中主动“调用”它。推荐两种方式：
-
声明式 Pipeline（推荐）：在
pipeline块顶部指定
pipeline {
agent any
tools {
jdk 'jdk-17' // 必须和全局工具里填的 Name 完全一致
maven 'maven-3.9'
}
stages {
stage('Build') {
steps {
sh 'java -version' // 这里将输出 jdk-17 的版本
}
}
}
}
-
脚本式 Pipeline：在
node内用tool获取路径并导出
node {
def javaHome = tool 'jdk-17'
withEnv(["JAVA_HOME=${javaHome}", "PATH+JAVA=${javaHome}/bin"]) {
sh 'java -version'
}
}
注意：tools 指令会自动把 $JAVA_HOME/bin 加入 PATH，无需手动处理。
补充：节点环境变量（针对 Agent 节点）
如果 Jenkins 使用了远程 Agent（比如 Linux 服务器做构建机），还需确保该 Agent 上的系统环境变量也一致：
- 编辑 Agent 机器的
/etc/profile或~/.bashrc - 添加两行（以 Linux 为例）：
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH
- 执行
source ~/.bashrc生效，并验证java -version
这步确保即使 Jenkins 没走 tools 指令，Shell 命令也能 fallback 到正确 JDK。
