jenkins构建失败因找不到jdk，主因是未安装jdk插件或未在全局工具配置中指定真实java_home路径；pipeline中需显式设置环境变量或使用withmaven确保jdk生效。
Java构建失败提示 No Java installation found
Jenkins 找不到 JDK，最常见原因是没装 JDK 插件，或插件装了但没在全局工具配置里声明路径。JDK 插件本身不自带 JDK，它只是个“指路牌”，真正要你手动填好系统里已有的 JDK 路径。
- 先确认是否安装了
JDK Tool插件（旧版叫JDK Installation Plugin），进Manage Jenkins → Manage Plugins → Available搜关键词安装 - 装完必须去
Manage Jenkins → Global Tool Configuration → JDK新增一个 JDK 条目，名字比如jdk-17，JAVA_HOME填真实路径（如/usr/lib/jvm/java-17-openjdk-amd64），别留空 - Linux 上如果用
apt install openjdk-17-jdk安装，路径通常不是/usr/bin/java（那是软链接），得用readlink -f $(which java)往上翻两级得到真实JAVA_HOME
Pipeline 中指定 JDK 失效：为什么 tool 'jdk-17' 不起作用
写在 pipeline 里的 tool 只影响当前 sh 步骤的环境变量，不会自动注入到 mvn 或 java 命令中——尤其当你用的是系统级 Maven（非 Jenkins 自带）时，它仍会读取系统默认 JAVA_HOME。
- 务必在
steps内显式设置环境变量：sh ''' export JAVA_HOME=${JAVA_HOME} export PATH=${JAVA_HOME}/bin:$PATH mvn clean package ''' - 更稳妥的做法是改用 Jenkins 自带的 Maven：在全局工具里配好
Maven，然后 pipeline 中用tool 'maven-3.9'+withMaven，它会自动桥接 JDK 环境 - 若用
sh直接调java -version，记得加-x看实际执行路径，避免被 shell alias 或 wrapper 脚本干扰
多 JDK 版本共存时，Jenkins 任务选错版本的典型表现
构建日志里 java -version 输出和你预期不符，或者编译报 source level 17 is not supported，大概率是 job 没绑定对 JDK，或者绑了但被上游流水线/父模板覆盖。
- Jenkins 的 JDK 绑定优先级：Pipeline 脚本内
tool> Job 配置页的Restrict where this project can be run下 JDK 选择 > 全局默认 JDK - 检查 job 配置页是否有
Provide JDK勾选项（旧版 UI），勾了却没选具体版本，就会退化成系统默认 - 用
envVars插件或在sh里打印echo $JAVA_HOME && java -version，确认实际生效路径，别只信配置名
tool、有没有覆盖环境变量、以及 Maven/Gradle 是否被正确引导。漏掉其中一环，就可能本地编译过、Jenkins 报错。 
