升级Gradle版本遇Flutter 3.13语义分析BUG：Unsupported major version 64

API 探路者

2026-7-11

解决Flutter 3.13升级Gradle时出现的Unsupported class file major version 64错误

这个错误的核心原因是你当前使用的Java版本是20（对应class文件major version 64），但Flutter 3.13配套的Gradle插件、Groovy版本不支持Java 20，导致编译Groovy代码时触发语义分析异常。

下面是具体的解决步骤：

降低Java版本到兼容范围
Flutter 3.13推荐使用Java 11或17，这两个版本能完美适配对应Gradle版本：
- 如果你用Android Studio，通过File > Project Structure > SDK Location找到JDK设置，切换到Java 11或17的安装目录；
- 手动配置的话，在项目根目录的gradle.properties里添加或修改：
```
org.gradle.java.home=/path/to/your/java11_or_17_jdk
```
- 也可以直接设置系统环境变量JAVA_HOME指向Java 11/17的路径。
匹配Gradle版本与Flutter版本
Flutter 3.13建议搭配Gradle 8.0+，同时要保证Gradle和Java版本兼容（Gradle 8.0支持Java 11-19）：
- 修改android/build.gradle中的Gradle插件版本：
```
dependencies {
    classpath 'com.android.tools.build:gradle:7.4.2'
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}
```
- 修改android/gradle/wrapper/gradle-wrapper.properties中的Gradle分发版本：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-all.zip
```
清理缓存后重新构建
执行以下操作彻底清理缓存，避免残留影响：
```
flutter clean
```
手动删除Android目录下的.gradle文件夹，最后运行：
```
flutter run
```