VSCode中SpringBoot+Gradle项目报错：无主类及插件版本不兼容

和同事在VSCode协作开发SpringBoot项目，同事的项目可正常运行，但我的项目出现两个问题：

• 提示无法找到包含main方法的类
• Gradle配置报错

已尝试调整Gradle插件、核对本地及VSCode的Java版本（均为17.0.5），但问题仍未解决。报错详情如下：

无法使用与Gradle发行版 'https://services.gradle.org/distributions/gradle-7.6.1-bin.zip' 的连接运行阶段构建操作。
org.gradle.api.ProjectConfigurationException: 配置根项目 'rezume_project' 时出现问题。
配置根项目 'rezume_project' 时出现问题。
无法解析配置 ':classpath' 的所有文件。
无法解析 org.springframework.boot:spring-boot-gradle-plugin:3.0.4。
被以下项目依赖：
    project : > org.springframework.boot:org.springframework.boot.gradle.plugin:3.0.4
未找到与 org.springframework.boot:spring-boot-gradle-plugin:3.0.4 匹配的变体。消费者被配置为寻找兼容Java 8的库运行时，打包为jar，依赖项外部声明，以及属性 'org.gradle.plugin.api-version' 值为 '7.6.1'，但：
  - 变体 'apiElements' 拥有能力 org.springframework.boot:spring-boot-gradle-plugin:3.0.4，声明为一个库，打包为jar，依赖项外部声明：
      - 不兼容，因为该组件声明了兼容Java 17的API组件，而消费者需要兼容Java 8的运行时组件
      - 其他兼容属性：
          - 未提及 org.gradle.plugin.api-version（要求值为 '7.6.1'）
  - 变体 'javadocElements' 拥有能力 org.springframework.boot:spring-boot-gradle-plugin:3.0.4，声明为组件的运行时，依赖项外部声明：
      - 不兼容，因为该组件声明为文档，而消费者需要库
      - 其他兼容属性：
          - 未提及目标Java版本（要求兼容Java 8）
          - 未提及元素打包方式（要求打包为jar）
          - 未提及 org.gradle.plugin.api-version（要求值为 '7.6.1'）
  - 变体 'mavenOptionalApiElements' 拥有能力 org.springframework.boot:spring-boot-gradle-plugin-maven-optional:3.0.4，声明为一个库，打包为jar，依赖项外部声明：
      - 不兼容，因为该组件声明了兼容Java 17的API组件，而消费者需要兼容Java 8的运行时组件
      - 其他兼容属性：
          - 未提及 org.gradle.plugin.api-version（要求值为 '7.6.1'）
  - 变体 'mavenOptionalRuntimeElements' 拥有能力 org.springframework.boot:spring-boot-gradle-plugin-maven-optional:3.0.4，声明为库的运行时，打包为jar，依赖项外部声明：
      - 不兼容，因为该组件声明兼容Java 17，而消费者需要兼容Java 8的组件
      - 其他兼容属性：
          - 未提及 org.gradle.plugin.api-version（要求值为 '7.6.1'）
  - 变体 'runtimeElements' 拥有能力 org.springframework.boot:spring-boot-gradle-plugin:3.0.4，声明为库的运行时，打包为jar，依赖项外部声明：
      - 不兼容，因为该组件声明兼容Java 17，而消费者需要兼容Java 8的组件
      - 其他兼容属性：
          - 未提及 org.gradle.plugin.api-version（要求值为 '7.6.1'）
  - 变体 'sourcesElements' 拥有能力 org.springframework.boot:spring-boot-gradle-plugin:3.0.4，声明为组件的运行时，依赖项外部声明：
      - 不兼容，因为该组件声明为文档，而消费者需要库
      - 其他兼容属性：
          - 未提及目标Java版本（要求兼容Java 8）
          - 未提及元素打包方式（要求打包为jar）
          - 未提及 org.gradle.plugin.api-version（要求值为 '7.6.1'）

排查与解决步骤 #

1. 修正Gradle的Java版本配置 #

报错核心是Gradle构建环境被强制使用Java 8，但Spring Boot 3.0.4要求Java 17。需要在项目中明确指定Java版本：

• 在gradle.properties中添加：

org.gradle.java.home=/path/to/your/java17
java.version=17

• 或者在build.gradle中添加：

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

2. 检查VSCode的Java运行时配置 #

打开VSCode设置（快捷键Ctrl+,），搜索并设置以下项为Java 17的路径：

• java.home
• java.configuration.runtimes（确保Java 17配置存在并设为默认）

3. 清理Gradle缓存并重新同步 #

• 执行本地命令清理缓存：

./gradlew clean build --refresh-dependencies

• 在VSCode的Gradle侧边栏点击"Refresh"按钮重新同步项目

4. 确认main方法类配置 #

• 检查启动类是否带有@SpringBootApplication注解
• 在build.gradle中明确指定启动类全路径：

springBoot {
    mainClass = 'com.example.rezume_project.RezumeProjectApplication'
}

5. 核对全局Gradle配置 #

检查用户目录下的~/.gradle/gradle.properties，确保没有全局强制使用Java 8的配置项。

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