新手在VS Code运行首个Flutter项目遇Gradle构建错误求解决

错误核心原因 #

你遇到的问题是Gradle版本与Java版本不兼容：当前使用的Gradle 7.5不支持Java 22（class file major version 66对应Java 22版本），导致构建时无法解析类文件。

具体解决步骤 #

1. 确认当前Java版本
   打开终端执行命令：

   java -version
   

   如果输出显示是Java 22，就需要调整版本。

2. 安装兼容的Java版本
   Gradle 7.5最高支持Java 17，下载安装Java 17（或Java 11，都是长期支持稳定版），记好安装路径。

3. 配置项目使用正确Java版本
   两种方式选其一即可：

   • VS Code全局配置：打开VS Code设置（快捷键Ctrl+,），搜索java.home，将路径设置为你安装的Java 17目录，比如C:\Program Files\Java\jdk-17.0.8
   • 项目局部配置：打开项目的android/gradle.properties文件，添加一行：

     org.gradle.java.home=C:\\Program Files\\Java\\jdk-17.0.8
     

     注意路径里的反斜杠要写双份。

4. 清理Gradle缓存
   删除C:\Users\mikeD\.gradle\caches目录下的所有内容，避免旧缓存残留干扰。

5. 重新构建项目
   在项目根目录打开终端，执行：

   flutter clean
   flutter run
   

备选进阶方案 #

如果不想降级Java，可以升级Gradle版本到8.6及以上（这些版本支持Java 22）：

• 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-all.zip
  

• 同时修改android/build.gradle中的com.android.tools.build:gradle版本为对应兼容版本，比如8.2.0：

  dependencies {
      classpath 'com.android.tools.build:gradle:8.2.0'
      // 保留其他原有依赖
  }
  

  新手更推荐第一种降级Java的方案，避免版本升级带来的额外配置问题。

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