Spring Boot项目Gradle构建失败：无法解析spring-boot-gradle-plugin:3.1.1

问题描述 #

配置根项目Task_Manager时出现依赖解析错误：

无法解析配置':classpath'的所有文件，无法解析org.springframework.boot:spring-boot-gradle-plugin:3.1.1。该插件由项目依赖的org.springframework.boot:org.springframework.boot.gradle.plugin:3.1.1所要求。未找到匹配的插件变体，消费者配置为寻找运行时可用、兼容Java 8、打包为jar、依赖外部声明且属性org.gradle.plugin.api-version值为8.1.1的库，但各变体存在如下不兼容情况：

• Variant 'apiElements'：声明为编译时组件，兼容Java 17，与消费者运行时、Java 8要求不兼容；未声明org.gradle.plugin.api-version属性
• Variant 'javadocElements'：为文档组件，非库类型；未声明目标Java版本、打包格式及org.gradle.plugin.api-version属性
• Variant 'mavenOptionalApiElements'：编译时组件，兼容Java 17，与消费者运行时、Java 8要求不兼容；未声明org.gradle.plugin.api-version属性
• Variant 'mavenOptionalRuntimeElements'：运行时组件，兼容Java 17，与消费者Java 8要求不兼容；未声明org.gradle.plugin.api-version属性
• Variant 'runtimeElements'：运行时组件，兼容Java 17，与消费者Java 8要求不兼容；未声明org.gradle.plugin.api-version属性
• Variant 'sourcesElements'：为文档组件，非库类型；未声明目标Java版本、打包格式及org.gradle.plugin.api-version属性

解决方案 #

1. 升级Java版本到17 #

Spring Boot 3.x系列最低要求Java 17，当前项目使用Java 8，版本不匹配是核心问题。将JDK升级到17或更高版本后，在build.gradle中指定版本：

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

2. 降级Spring Boot插件版本（保留Java 8） #

如果必须使用Java 8，需将Spring Boot插件降级到2.x系列（最高支持Java 8的稳定版本为2.7.x），修改build.gradle的插件配置：

plugins {
    id 'org.springframework.boot' version '2.7.14'
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
}

3. 匹配Gradle版本 #

• 若使用Spring Boot 3.x + Java 17，Gradle 8.x可直接兼容，无需修改。
• 若降级到Spring Boot 2.x + Java 8，建议使用Gradle 7.x版本（Gradle 8.x对Java 8支持有限），修改gradle/wrapper/gradle-wrapper.properties：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.4-bin.zip

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