当前位置：首页 > news >正文

通过 java-version 和 distribution 参数灵活设置 JDK 环境

news 2026/7/12 8:21:34

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 package

3.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参数。