Android Studio Electric Eel运行Flutter项目时Gradle构建失败报错

错误详情 #

构建失败，异常信息如下：

• 错误位置：构建文件 C:\Users\sanje\AndroidStudioProjects\weather_app\android\build.gradle 第26行
• 核心报错：

  评估根项目 'android' 时出现问题。
  配置项目 ':app' 时出现问题。
  无法为构建文件 'C:\Users\sanje\AndroidStudioProjects\weather_app\android\app\build.gradle' 打开通用类缓存（路径：C:\Users\sanje.gradle\caches\7.4\scripts\cusw5g2nbmmntllzldoslifyq）。
  错误！在源单元 'BuildScript' 的 '语义分析' 阶段出现异常：Unsupported class file major version 63

构建在3秒内失败，最终异常：Gradle任务 assembleDebug 执行失败，退出码为1

错误原因 #

Unsupported class file major version 63 表示当前运行Gradle的JDK版本无法识别JDK 17编译的class文件（class文件版本63对应JDK 17）。常见诱因：

• Gradle版本与JDK版本不兼容（旧版Gradle不支持JDK 17）
• Android Studio配置的JDK版本低于17，但项目依赖了JDK 17编译的库或脚本

解决方案 #

方案1：确保Gradle版本兼容JDK 17 #

Gradle 7.3及以上版本正式支持JDK 17，你当前使用的是Gradle 7.4，理论上兼容，可按以下步骤修复：

1. 清理Gradle缓存：删除目录 C:\Users\sanje\.gradle\caches\7.4
2. 打开项目根目录的 gradle/wrapper/gradle-wrapper.properties，确认distributionUrl指向Gradle 7.4版本的分发包（如gradle-7.4-bin.zip）
3. 同步项目后重新执行构建

方案2：降低项目使用的JDK版本 #

若不想调整Gradle，可将项目JDK版本降至11或8（Gradle 7.4兼容这两个版本）：

1. 打开Android Studio，进入 File > Project Structure > SDK Location，在JDK location选择JDK 11或8的安装路径
2. 修改app/build.gradle中的编译配置：

   android {
       compileOptions {
           sourceCompatibility JavaVersion.VERSION_11
           targetCompatibility JavaVersion.VERSION_11
       }
       // 若项目使用Kotlin，添加以下配置
       kotlinOptions {
           jvmTarget = "11"
       }
   }
   

3. 清理项目缓存（Build > Clean Project）后重新构建

方案3：检查第三方依赖版本 #

若项目引入的第三方依赖是用JDK 17编译的，需替换为兼容JDK 11/8的版本，或升级Gradle适配高版本依赖

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