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。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 务必在 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，确认实际生效路径，别只信配置名

JDK 插件本身不解决版本冲突，它只负责把名字映射到路径；真正决定用哪个 JDK 的，是你在哪儿写 tool、有没有覆盖环境变量、以及 Maven/Gradle 是否被正确引导。漏掉其中一环，就可能本地编译过、Jenkins 报错。