已配置Java路径但GitLab Pipeline中找不到java命令问题排查

核心问题 #

你配置的JAVA_HOME和ANT_HOME是Windows本地的C盘路径，但GitLab Runner是在Linux环境下运行的（从报错里的/bin/bash能直接判断）。Linux系统根本认不出C:\这种Windows路径格式，自然找不到java命令。

必须执行的操作 #

肯定要把JDK和Ant部署到GitLab Runner所在的Linux服务器上，具体步骤：

1. 下载对应Linux版本的JDK 17和Apache Ant 1.10.13，上传到Runner服务器的指定目录（比如/opt/software/）
2. 解压安装包，修改Pipeline里的环境变量配置为Linux路径：

   export JAVA_HOME="/opt/software/jdk-17.0.5"
   export ANT_HOME="/opt/software/apache-ant-1.10.13"
   export PATH=${JAVA_HOME}/bin:$PATH
   export PATH=$PATH:${ANT_HOME}/bin
   

3. 重新执行Pipeline，验证java -version和ant -version是否正常输出

额外优化建议 #

• 可以把JDK和Ant的环境变量配置到Runner服务器的全局环境中（比如/etc/profile或Runner用户的.bashrc），避免每次Pipeline都重复配置
• 如果使用Docker类型的GitLab Runner，更简便的方式是直接用包含Java和Ant的官方镜像，比如在.gitlab-ci.yml中这样配置：

  image: openjdk:17-jdk-slim
  before_script:
    - apt-get update && apt-get install -y ant
  

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