Flutter项目运行报错：Unsupported class file major version 63

错误核心原因 #

这个报错是Java版本与当前Gradle版本不兼容导致的：

• Class file major version 63对应Java 19
• 你使用的Gradle 7.3.3最高仅支持Java 17，无法识别Java 19编译的类文件，进而在语义分析阶段抛出异常。

具体解决方法 #

方法1：降级Java版本到17 #

• 卸载当前的Java 19，安装Java 17（OpenJDK或Oracle JDK均可）
• 配置系统环境变量：
  • 将JAVA_HOME设置为Java 17的安装路径
  • 确保系统PATH中Java 17的bin目录优先级最高
• 重启IDE（Android Studio/VS Code）后重新运行项目

方法2：升级Gradle版本以支持Java 19 #

1. 打开项目的android/build.gradle文件，更新Gradle插件版本：

   dependencies {
       classpath 'com.android.tools.build:gradle:7.4.2' // 或更高支持Java19的版本
       classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
   }
   

2. 打开android/gradle/wrapper/gradle-wrapper.properties，修改Gradle分发版本：

   distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-bin.zip // 7.6及以上版本支持Java19
   

3. 同步项目后重新构建

方法3：在IDE中单独指定项目JDK版本 #

如果不想全局修改Java版本，可在IDE中单独配置：

• 打开Android Studio，进入File > Project Structure > SDK Location
• 在JDK location选择Java 17的安装路径
• 点击Apply同步项目后重新运行

额外排查步骤 #

• 确认local.properties中的flutter.sdk路径正确，指向你的Flutter SDK根目录
• 清理Gradle缓存：删除C:\Users\patel\.gradle\caches下7.3.3相关的缓存文件夹，再重新构建项目

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