Kotlin Spring Boot 3升级报错：无法解析spring-boot-gradle-plugin:3.0.0

问题描述 #

升级Kotlin/Spring项目到Spring Boot 3.0.0时，遇到Gradle依赖解析错误：

Could not resolve org.springframework.boot:spring-boot-gradle-plugin:3.0.0.

当前插件声明如下：

plugins {
        id 'io.spring.dependency-management' version '1.1.0' // 当时的最新版本
        id 'org.springframework.boot' version '3.0.0'
        id 'org.jetbrains.kotlin.plugin.jpa' version '1.7.10'
        id 'org.jetbrains.kotlin.plugin.spring' version '1.7.10'
}

完整错误输出见截图：

已尝试操作：

• 切换至Java 17
• 截至2022年11月29日美东时间上午10点，未搜索到有效解决方案

可能的解决方法 #

1. 升级Gradle到兼容版本 #

Spring Boot 3.0.0要求Gradle版本至少为7.5，若当前版本过低会导致插件解析失败。修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl，示例：

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

2. 补全插件仓库配置 #

在settings.gradle中确保配置了必要的插件仓库，避免因仓库缺失无法拉取插件：

pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
        maven { url = uri("https://repo.spring.io/release") }
    }
}

3. 强制刷新Gradle缓存 #

缓存损坏可能引发解析异常，执行命令清理并刷新缓存：

./gradlew clean build --refresh-dependencies

4. 调整插件声明顺序 #

尝试将Spring Boot插件放在dependency-management插件之前，避免依赖管理插件干扰解析：

plugins {
        id 'org.springframework.boot' version '3.0.0'
        id 'io.spring.dependency-management' version '1.1.0'
        id 'org.jetbrains.kotlin.plugin.jpa' version '1.7.10'
        id 'org.jetbrains.kotlin.plugin.spring' version '1.7.10'
}

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