Docker构建Gradle项目报JAVA_HOME无效与本地设置不符

Docker构建阶段运行在和宿主机完全隔离的中间容器环境中，你在Mac本地配置的JAVA_HOME环境变量、项目根目录下写入的gradle.properties配置，都不会自动同步到Docker构建容器内部，因此你本地的配置对容器内的Gradle构建流程完全不生效。
报错中提到的/opt/java/openjdk是你使用的Docker基础镜像内预设的默认JAVA_HOME路径，出现该报错的原因只有两类：

• 选用的基础镜像未预装对应版本JDK，但硬编码了无效的JAVA_HOME环境变量
• 构建流程中某一步骤误删除/覆盖了基础镜像内的JDK文件，导致预设路径下找不到可用的Java运行环境

• 不要尝试将Mac本地的JDK路径映射、配置到Docker构建容器中：MacOS与Docker容器的文件系统、内核架构存在差异，直接引用宿主机JDK路径必然失败。
• 优先更换为官方维护的带匹配JDK版本的Gradle基础镜像，这类镜像已经提前配置好了正确的JAVA_HOME变量，不会出现路径无效问题，参考Dockerfile构建片段：

# 构建阶段使用官方Gradle镜像，按需选择匹配你项目的Gradle、JDK版本即可
FROM gradle:7.6.1-jdk17 AS build
WORKDIR /workspace
COPY . .
# 加--no-daemon参数避免容器内Gradle后台驻留导致构建卡住
RUN gradle build --no-daemon

# 运行阶段使用精简JRE镜像减小最终镜像体积
FROM eclipse-temurin:17-jre
WORKDIR /app
COPY --from=build /workspace/build/libs/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

• 如果必须使用现有基础镜像，可在Dockerfile中执行RUN gradle build前，先确认镜像内JDK的实际安装路径，再显式设置正确的JAVA_HOME环境变量：

# 构建时先执行which java定位JDK实际路径，确认后替换下方ENV中的路径值
RUN which java
ENV JAVA_HOME=/usr/lib/jvm/temurin-17-jdk-amd64
RUN gradle build --no-daemon

• 额外检查项目根目录下的exec.sh脚本内容，确认脚本中执行docker build时没有传入错误的JAVA_HOME构建参数，也没有错误挂载卷覆盖镜像内的JDK目录。

你之前在本地gradle.properties中配置org.gradle.java.home指向Mac本地JDK路径的操作无效，因为容器内的Gradle读取该配置时，查找的是容器内部的文件系统路径，该路径下不存在你Mac宿主机上的JDK文件。

内容的提问来源于stack exchange，提问作者Aphorism44