在CI/CD流水线中设置Java环境变量的核心是不依赖本地配置，而是在流水线运行时动态安装并声明JAVA_HOME与PATH，需显式安装JDK（如openjdk-17-jdk）、验证java -version及which java，并适配Maven等工具链，优先使用平台内置变量（如WORKSPACE）和全局工具配置以保障一致性。
在 CI/CD 流水线中设置 Java 环境变量，核心是**不依赖本地配置，而是在流水线运行时动态安装并声明环境变量**。远程 runner（如 GitLab Runner 或 Jenkins agent）运行在独立容器或虚拟机中，与你的开发机完全隔离，Windows 路径、本地 JAVA_HOME、甚至已安装的 JDK 都不可见、不可用。
明确指定 JDK 版本并安装
不要假设环境已有 JDK；必须显式安装所需版本。不同平台方式略有差异：
- GitLab CI（基于 Ubuntu 镜像）：用 apt 安装 OpenJDK，并设 JAVA_HOME
before_script: - apt-get update && apt-get install -y openjdk-17-jdk - export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 - export PATH=$JAVA_HOME/bin:$PATH
- Jenkins Pipeline（Linux agent）：可在全局工具配置中预装 JDK，或在 pipeline 中用 sh 命令安装
-
推荐做法：使用 Docker 镜像直接带 JDK，例如
openjdk:17-jdk-slim，避免每次构建都重装
验证 Java 环境是否生效
仅设置变量不够，必须验证命令可用性，防止因路径错误或权限问题导致后续构建失败：
- 在流水线脚本中加入校验步骤：
java -version && javac -version - 检查 JAVA_HOME 是否指向有效目录：
ls -l $JAVA_HOME - 确认 java 命令可被 PATH 找到：
which java
建议将校验逻辑放在 before_script（GitLab）或 sh 步骤开头（Jenkins），失败即中断，避免浪费资源。
立即学习“Java免费学习笔记（深入）”；
适配构建工具链（如 Maven/Ant）
Java 环境只是基础，Maven、Ant 等工具还需额外配置：
- Maven：通常通过包管理器安装（
apt install maven），或使用maven:3.8-openjdk-17镜像，自动继承 JAVA_HOME - Ant：需单独安装（
apt install ant），并确保ANT_HOME和PATH正确设置 - 关键点：所有工具路径必须基于 Linux 文件系统，禁用
C:\Program Files\...类 Windows 路径
避免硬编码，优先使用平台内置变量
CI 平台会自动注入一批可靠变量，应优先利用而非重复定义：
-
CI=true：标识当前为 CI 环境，可用于条件判断 -
WORKSPACE（Jenkins）或$CI_PROJECT_DIR（GitLab）：代码检出根目录，适合存放临时产物 - 部分平台支持“全局工具配置”（如 Jenkins 的 JDK 管理），可统一维护多个 JDK 版本供 job 选择，提升复用性和一致性
自定义变量（如 MAVEN_OPTS）建议通过平台 UI 或配置文件注入，而非写死在脚本里，便于多环境切换和权限管控。
