Flutter构建报错：Unsupported class file major version 63 求助

错误详情 #

FAILURE: Build failed with an exception.

* What went wrong:
Could not open settings generic class cache for settings file 'C:\Users\Ozgur\Documents\flutterprojects\android\settings.gradle' (C:\Users\Ozgur\.gradle\caches\7.4\scripts\ea4ydi90mwjg9g63m7r6nimmx).
> BUG! exception in phase 'semantic analysis' in source unit '_BuildScript_' Unsupported class file major version 63

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 1s
Exception: Gradle task assembleDebug failed with exit code 1

问题根源 #

当前使用的Gradle 7.4不支持JDK 19（class file major version 63对应JDK19），两者版本不匹配导致构建失败。

解决方案 #

方案1：降级JDK到兼容版本 #

• 卸载JDK19，安装JDK17（LTS长期支持版本，稳定性更好）
• 重新配置JAVA_HOME环境变量指向JDK17的安装路径
• 打开命令行执行java -version和javac -version，确认版本切换成功

方案2：升级Gradle版本到7.5及以上 #

• 打开项目目录下的android/gradle/wrapper/gradle-wrapper.properties文件
• 修改distributionUrl为兼容JDK19的Gradle版本，示例：

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

• 保存文件后，执行flutter run，Gradle会自动下载并使用新版本

方案3：清理Gradle缓存 #

• 删除C:\Users\Ozgur\.gradle\caches目录下的所有缓存文件
• 重新执行flutter run构建项目

内容的提问来源于stack exchange，提问作者Özgür Uçar