使用Flutter构建应用时遇Android Studio报错：Unsupported class file major version 63

错误核心原因 #

Gradle 7.5 不支持 Java 19（对应class文件版本63），需使用Java 17或更低版本。你更换Java版本后问题仍存在，大概率是Android Studio配置、项目Gradle设置或系统环境变量未同步更新导致的。

具体修复步骤 #

1. 安装兼容的Java版本 #

• 安装Java 17（推荐Adoptium或Oracle JDK 17），确保安装路径无中文、空格等特殊字符。

2. 配置Android Studio的JDK #

• 打开Android Studio，依次点击 File > Project Structure > SDK Location
• 在JDK location选项中选择已安装的Java 17路径，点击Apply保存配置。

3. 调整项目Gradle相关配置 #

• 打开项目根目录下的android/gradle/wrapper/gradle-wrapper.properties，确认Gradle版本与Java 17兼容：

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

  （若要适配Java 19，可将Gradle版本升级至7.6及以上，同步修改该路径为对应版本的下载链接）
• 打开android/build.gradle，同步构建工具版本与Java版本：

  buildscript {
      ext.kotlin_version = '1.7.10'
      repositories {
          google()
          mavenCentral()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:7.4.2'
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
      }
  }
  

• 打开app模块的android/app/build.gradle，明确指定Java版本：

  android {
      compileSdkVersion 33
  
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_17
          targetCompatibility JavaVersion.VERSION_17
      }
      kotlinOptions {
          jvmTarget = '17'
      }
  }
  

4. 清理缓存并重新构建 #

• 删除本地Gradle缓存文件夹：C:\Users\rayha\.gradle\caches
• 回到Android Studio，点击File > Invalidate Caches... > Invalidate and Restart
• 重启后执行命令行指令：flutter clean，再重新运行项目。

5. 检查系统环境变量 #

• 确保系统JAVA_HOME环境变量指向Java 17的安装路径，PATH变量中优先包含该JDK的bin目录。
• 打开命令行执行java -version和javac -version，确认输出为Java 17版本。

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