在 GitLab Pipeline 中配置 JAVA_HOME 和 PATH 后仍提示 java: command not found，根本原因是 Runner 运行在远程 Linux 容器（如 Ubuntu）中，无法访问本地 Windows 路径；需在 CI 任务中显式安装 OpenJDK 和 Ant。

在 gitlab pipeline 中配置 java_home 和 path 后仍提示 `java: command not found`，根本原因是 runner 运行在远程 linux 容器（如 ubuntu）中，无法访问本地 windows 路径；需在 ci 任务中显式安装 openjdk 和 ant。

GitLab CI/CD 的执行环境与开发者本地机器完全隔离——Pipeline 默认运行在 GitLab Runner 所托管的 Linux（通常是 Ubuntu）容器或虚拟机中，所有环境变量（如 JAVA_HOME、PATH）和文件路径都必须在该目标环境中定义和存在。您在脚本中设置的 C:\Program Files\Java\jdk-17.0.5 是 Windows 路径，在 Linux Runner 上不仅无效，还会导致 PATH 拼接失败（Linux 不识别反斜杠和盘符），因此 java 命令自然无法被 shell 找到。

✅ 正确做法是：在 .gitlab-ci.yml 的 script 阶段中，通过包管理器（如 apt）安装 JDK 和 Ant，并验证其可用性。以下为推荐实践：

build:
  image: ubuntu:22.04
  script:
    - apt-get update && apt-get install -y openjdk-17-jdk ant curl wget unzip
    - java -version
    - javac -version
    - ant -version
    - ant clean build  # 执行您的构建目标

⚠️ 注意事项：

GitHub & Developer Data

面向AI代理的GitHub及开发者数据——仓库元数据（星标、语言、许可证）、仓库审计与风险评分、用户资料、最新发布和gist内容...

下载

• 避免硬编码 Windows 路径：CI 脚本中禁止使用 C:\... 或 export JAVA_HOME="C:\..."，这在 Linux 下无意义；
• 优先选用发行版官方 JDK：如 openjdk-17-jdk（推荐 LTS 版本），比手动下载 JDK 更可靠、安全且兼容 CI 环境；
• 确保 ant 依赖 Java：apt install ant 会自动拉取对应 JDK，但显式安装 openjdk-17-jdk 可保证版本可控；
• 可选：缓存加速：若频繁运行，可在 cache: 中缓存 /usr/lib/jvm 或使用预装 JDK 的基础镜像（如 openjdk:17-jdk-slim），提升构建速度；
• 权限与用户：默认 Runner 以 root 或无特权用户运行，apt install 无需额外提权，但切勿在 CI 中尝试挂载宿主机路径或修改系统级环境变量。

总结：GitLab Pipeline 的环境是“一次性的、纯净的、远程的”。任何依赖（JDK、Ant、Node.js 等）都必须在 script 中显式安装并验证，而非复用本地配置。这是 CI/CD 可重现性与可靠性的基石。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南