gitlab 流水线运行在远程 runner（通常是 linux 容器）上，无法访问本地 windows 路径；必须在流水线脚本中显式安装 jdk 和 ant，而非依赖本地环境变量或路径映射。
gitlab 流水线运行在远程 runner（通常是 linux 容器）上，无法访问本地 windows 路径；必须在流水线脚本中显式安装 jdk 和 ant，而非依赖本地环境变量或路径映射。
在 GitLab CI/CD 中构建 Java 项目（尤其是使用 Apache Ant 的传统项目）时，一个常见误区是试图将本地开发机的环境（如 JAVA_HOME、ANT_HOME 和 PATH）直接复用到流水线中。正如示例所示，即使你在 .gitlab-ci.yml 中用 export 设置了 Windows 风格路径（如 C:\Program Files\Java\jdk-17.0.5），该路径对运行在 Ubuntu Docker 镜像上的 GitLab Runner 完全无效——不仅路径格式不兼容（Windows vs Linux），更关键的是：Runner 运行在隔离容器中，与你的本地文件系统完全无关。
✅ 正确做法是：在流水线作业中，通过包管理器（如 apt）安装所需工具链，并验证其可用性。以下是一个稳定、可复用的配置示例（适用于默认 ubuntu:latest 或 docker:stable 类 Runner）：
build-with-ant:
image: ubuntu:22.04
before_script:
- apt-get update && apt-get install -y wget curl unzip gnupg ca-certificates
- apt-get install -y openjdk-17-jdk ant # 推荐 JDK 17（LTS），兼容 Ant 1.10+
- java -version
- ant -version
script:
- ant clean compile test⚠️ 注意事项：
- 不要使用 export JAVA_HOME=... 指向本地路径，这在 CI 中无意义；
- 避免硬编码 Windows 路径（如 C:\...）或反斜杠 \，Linux shell 会解析失败；
- 若需特定 JDK 版本（如 JDK 17.0.5），apt 默认源可能不提供精确小版本；此时建议改用 SDKMAN! 或官方 tar.gz + 手动解压（需配合 update-alternatives 配置）；
- 使用 openjdk-17-jdk（而非 openjdk-8-jdk）更符合现代 Java 项目要求，Ant 1.10+ 对 JDK 17 支持良好；
- 建议在 before_script 中显式执行 java -version 和 ant -version，便于快速定位环境问题。
? 总结：GitLab CI 的本质是“声明式环境重建”，不是“本地环境迁移”。一切依赖都应通过安装指令显式声明，而非假设路径存在。坚持这一原则，即可避免绝大多数“command not found”类故障。
立即学习“Java免费学习笔记（深入）”；
