Flutter项目模拟器运行失败：Gradle与Java版本不兼容报错

API 探路者

2026-7-27

解决方案：Java与Gradle版本不兼容问题修复

核心问题确认

你遇到的Unsupported class file major version 63错误确实是Java版本与Gradle不匹配导致的——Java 19对应的class文件版本是63，而项目中使用的Gradle脚本或插件对高版本Java的支持不完善，或是Android Studio的JDK配置未正确关联。

具体修复步骤

1. 切换到兼容的Java版本

Gradle 8.0.2官方推荐使用Java 17（长期支持版），稳定性更强：

打开Android Studio，进入File > Project Structure > SDK Location
在JDK location处选择Java 17，若未安装，点击Download JDK即可自动完成安装
打开项目根目录下的gradle.properties文件，添加以下配置（替换为你的Java 17实际安装路径）：
```
org.gradle.java.home=C:\Program Files\Java\jdk-17.x.x
```

2. 同步Gradle配置

点击Android Studio右上角的Sync Project with Gradle Files按钮，等待同步完成后重新尝试运行模拟器。

3. 匹配Gradle插件版本

打开项目android/build.gradle文件，确保Gradle插件版本与Gradle版本适配：

buildscript {
    ext.kotlin_version = '1.8.0'
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:8.0.0' // 适配Gradle 8.0.2和Java 17
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}