Gitlab CI构建Docker镜像时JAVA_HOME路径无效问题求助

问题场景 #

使用GitLab CI构建Docker镜像时，基于gradle:jdk17镜像的Dockerfile执行gradle build -x test命令时抛出错误：

ERROR: JAVA_HOME is set to an invalid directory: /opt/java/openjdk
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation.

但切换到gradle:jdk17-alpine镜像构建其他服务时，相同的JAVA_HOME路径却能正常运行。相关CI配置和Dockerfile如下：

GitLab CI作业配置 #

vcrawler-finance-docker-build:
  stage: build image
  only:
    refs:
      - main
    changes:
      - cicd/vcrawler/finance_control
  variables:
    SERVICE_NAME: 'vcrawler'
    FILE_CONTROL_NAME: 'finance_control'
    DOCKER_FILE: 'Dockerfile_finance'
  script:
    - sh cicd/build_crawler.sh
  artifacts:
    reports:
      dotenv:
        - vcrawler/build_vcrawler.env

构建用Dockerfile #

FROM --platform=linux/amd64 gradle:jdk17 as builder
WORKDIR /home/gradle
COPY ./build.gradle .
COPY . /home/gradle
COPY ./persistence ./persistence
RUN gradle build -x test
...

解决方案 #

1. 显式指定JAVA_HOME执行gradle命令 #

在Dockerfile的RUN命令中直接指定JAVA_HOME，确保gradle调用正确的Java环境：

RUN JAVA_HOME=/opt/java/openjdk gradle build -x test

也可以先验证路径有效性，再执行构建：

RUN ls -ld /opt/java/openjdk && JAVA_HOME=/opt/java/openjdk gradle build -x test

2. 更换gradle镜像的具体版本tag #

gradle:jdk17是通用tag，可能存在版本迭代导致的环境配置问题。尝试使用带具体gradle版本的镜像tag：

FROM --platform=linux/amd64 gradle:8.6-jdk17 as builder

这种方式能避免通用tag指向的镜像版本不稳定带来的问题。

3. 检查COPY操作是否覆盖容器环境配置 #

Dockerfile中COPY . /home/gradle会将本地项目所有文件复制到容器内，如果项目根目录存在.env、profile等会修改环境变量的文件，可能覆盖容器默认的JAVA_HOME设置。可以：

• 在.dockerignore中添加这类文件，避免复制到容器
• 调整COPY顺序，先执行gradle构建，再复制非必要文件（业务逻辑允许的情况下）

4. 在GitLab CI中显式传递JAVA_HOME变量 #

尝试在CI作业的variables中添加JAVA_HOME配置，确保容器启动时继承正确的环境变量：

vcrawler-finance-docker-build:
  # ... 其他配置
  variables:
    # ... 现有变量
    JAVA_HOME: '/opt/java/openjdk'

内容的提问来源于stack exchange，提问作者Nam V. Do