在 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 # 执行您的构建目标⚠️ 注意事项：
- 避免硬编码 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免费学习笔记（深入）”；
