Jenkins Pipeline构建Docker镜像时Gradle JAVA_HOME校验失败问题

1. 优先排查环境变量透传覆盖问题 #

这是本地构建正常、Jenkins环境构建失败场景下最高发的诱因：

• Jenkins执行docker build时，默认会把宿主机上Jenkins进程的部分环境变量透传到镜像构建的RUN执行阶段，极有可能覆盖官方镜像内预设的正确JAVA_HOME路径，或是传入其他和Java运行相关的环境变量干扰gradlew的路径判断逻辑。
• 先在Dockerfile的Gradle构建步骤前插入调试命令，确认构建阶段的实际运行上下文：

FROM gradle:7.4.2-jdk8 as builder

COPY --chown=gradle:gradle . /home/gradle/src
WORKDIR /home/gradle/src
# 调试用：打印当前执行用户、JAVA_HOME实际值、java二进制权限、直接执行java验证可用性
RUN whoami && echo "JAVA_HOME=$JAVA_HOME" && ls -l $JAVA_HOME/bin/java && $JAVA_HOME/bin/java -version
RUN gradle build --no-daemon

• 如果调试输出发现JAVA_HOME值被篡改，直接在Dockerfile里显式声明正确路径即可修复：

ENV JAVA_HOME=/opt/java/openjdk

• 如果调试时发现执行RUN命令的用户不是预设的gradle用户而是root，在构建步骤前显式指定运行用户即可：

USER gradle

2. 其次排查文件系统挂载的noexec权限问题 #

如果上一步调试时ls -l显示java二进制有可执行权限，但直接执行$JAVA_HOME/bin/java -version报Permission denied，就是挂载参数导致的：

• Jenkins节点如果默认开启Docker BuildKit，构建过程中会自动把宿主机的临时目录、缓存目录以*noexec（禁止执行二进制）*权限挂载到构建容器内，如果Java二进制、gradlew脚本刚好落在这些挂载目录下，就会触发可执行权限校验失败，报出JAVA_HOME无效的误导性错误。
• 可选修复方案：
  • 临时关闭BuildKit验证：在Jenkins执行docker build的步骤前加环境变量DOCKER_BUILDKIT=0，重新构建确认问题是否消失
  • 保留BuildKit的场景下，在Dockerfile中显式指定Gradle用户缓存目录到非临时挂载路径：

ENV GRADLE_USER_HOME=/home/gradle/.gradle
RUN mkdir -p $GRADLE_USER_HOME

3. 最后排查gradlew脚本本身的权限问题 #

你提到报错逻辑来自项目内的gradlew脚本校验，还需要确认COPY进镜像的gradlew脚本本身的可执行权限：

• 代码在Jenkins节点拉取时，git可能会丢失本地原本的可执行权限位，导致COPY进镜像的gradlew没有执行权限，触发Gradle调用wrapper时的权限校验误判。
• 直接在构建步骤前给gradlew补权限即可：

RUN chmod +x ./gradlew

内容的提问来源于stack exchange，提问作者aquitted-mind