Gitlab CI构建报错：升级Java11到17后spring-boot-gradle-plugin无法解析

本地IntelliJ构建Spring Boot应用正常，但GitLab CI流水线构建失败——CI环境默认使用Java11，而spring-boot-gradle-plugin:3.0.2要求Java17。尽管已在build.gradle中配置了Java 17的编译兼容性：

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

但GitLab CI构建日志显示，Gradle仍以Java11环境运行，导致插件依赖解析失败（核心错误：消费者需要兼容Java11的运行时组件，而Spring Boot插件仅兼容Java17）。

以下是几种可行的解决方式：

方法1：在GitLab CI配置中指定Java17镜像 #

修改.gitlab-ci.yml，使用预安装Java17的官方镜像，比如Eclipse Temurin的JDK镜像：

build:
  image: eclipse-temurin:17-jdk
  script:
    - export GRADLE_USER_HOME="$(pwd)/.gradle"
    - ./gradlew --build-cache assemble

这种方式让CI容器直接运行在Java17环境中，从根源解决JDK版本不兼容问题。

方法2：使用Gradle工具链强制指定JDK版本 #

在build.gradle中配置Gradle工具链，让Gradle自动下载并使用Java17执行构建任务，不受CI环境默认JDK版本影响：

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

该方式的优势是跨环境一致性，本地开发和CI构建都会使用指定版本的JDK，无需依赖环境配置。

方法3：在CI脚本中手动安装并切换Java17 #

如果无法更换CI镜像，可在构建脚本中手动安装Java17并切换环境变量（以Debian/Ubuntu系镜像为例）：

build:
  script:
    - apt-get update && apt-get install -y openjdk-17-jdk -qq
    - export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
    - export PATH="$JAVA_HOME/bin:$PATH"
    - export GRADLE_USER_HOME="$(pwd)/.gradle"
    - ./gradlew --build-cache assemble

此方式适合受限于现有镜像的场景，但会增加构建时间，需注意镜像的包管理工具是否匹配（如Alpine镜像需用apk而非apt-get）。

内容的提问来源于stack exchange，提问作者Vishal