1. 引言
在现代 Java 项目开发中，尤其是在持续集成/持续部署（CI/CD）流水线、多模块项目或团队协作场景下，确保开发、测试和生产环境使用统一且正确的 JDK 版本至关重要。手动下载、安装和配置不同版本的 JDK 不仅繁琐，而且容易出错。幸运的是，通过使用java-version和distribution参数，我们可以灵活、自动化地设置所需的 JDK 环境。
2. 核心参数解析
2.1 java-version 参数
java-version参数用于指定所需的 Java 版本。其值可以是具体的版本号（如17,11,1.8），也可以是版本范围（如17+）或最新的 LTS 版本标识（如lts）。
- 精确版本：例如
java-version: 17，将确保环境使用 JDK 17。 - 版本范围：例如
java-version: 11+，将使用 JDK 11 或更高版本（优先选择 11）。 - LTS 版本：例如
java-version: lts，将自动选择当前可用的最新长期支持版本。
2.2 distribution 参数
distribution参数用于指定 JDK 的发行版。不同的发行版在性能、许可协议和附加工具上可能有所差异。常见的发行版包括：
- temurin：由 Adoptium 社区提供的 Eclipse Temurin，是广泛使用的开源发行版。
- zulu：Azul Zulu，基于 OpenJDK，提供免费版本和商业支持。
- corretto：Amazon Corretto，亚马逊提供的免费、多平台、生产就绪的 OpenJDK 发行版。
- liberica：BellSoft Liberica JDK，另一个流行的 OpenJDK 发行版。
- microsoft：Microsoft Build of OpenJDK。
通过组合这两个参数，可以精确控制项目所使用的 JDK 环境。
3. 实践应用示例
3.1 在 GitHub Actions 中配置
在 GitHub Actions 的 workflow 文件中，可以使用actions/setup-java动作来配置 JDK。
jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Set up JDK 17 (Temurin) uses: actions/setup-java@v4 with: java-version: '17' distribution: 'temurin' - name: Build with Maven run: mvn clean package3.2 在 Gradle 构建脚本中配置
在 Gradle 的gradle-wrapper.properties或构建脚本中，也可以指定工具链，确保构建使用特定的 JDK。
// build.gradle.kts java { toolchain { languageVersion.set(JavaLanguageVersion.of(17)) vendor.set(JvmVendorSpec.ADOPTIUM) // 对应 Temurin } }3.3 在 Dockerfile 中配置
在构建 Docker 镜像时，可以使用多阶段构建或直接从官方镜像获取指定版本和发行版的 JDK。
# 使用 Eclipse Temurin 的 JDK 17 作为基础镜像 FROM eclipse-temurin:17-jdk-alpine AS builder WORKDIR /app COPY . . RUN ./gradlew build 运行时使用更小的 JRE 镜像 FROM eclipse-temurin:17-jre-alpine COPY --from=builder /app/build/libs/*.jar app.jar ENTRYPOINT ["java", "-jar", "/app.jar"]4. 优势与最佳实践
- 环境一致性：确保从本地开发到 CI/CD 再到生产部署，所有环节使用完全相同的 JDK 版本和发行版，避免“在我机器上能运行”的问题。
- 灵活切换：项目需要升级或降级 JDK 版本时，只需修改一个参数配置，无需手动重装。
- 可复现性：将 JDK 配置作为代码的一部分，使得任何环境都能快速、准确地复现出相同的构建环境。
- 建议：在项目根目录的配置文件（如
.github/workflows/ci.yml,gradle.properties）中集中管理java-version和distribution参数。
5. 总结
通过java-version和distribution参数来管理 JDK 环境，是一种高效、可靠且现代化的实践。它极大地简化了 Java 项目的环境配置工作，提升了团队协作效率和软件交付质量。无论是个人项目还是企业级应用，都建议采用这种方式来定义和锁定 JDK 依赖。
