Flutter项目Gradle构建失败求助：类缓存无法打开及版本兼容问题

执行构建命令：

C:\src\flutter\bin\flutter.bat --no-color build apk

构建过程抛出错误：

启用健全空安全构建
正在运行Gradle任务'assembleRelease'...
FAILURE: 构建过程中出现异常。

• 问题原因：
  无法为设置文件'C:\Users\sajoy\StudioProjects\untitled1\android\settings.gradle'打开设置通用类缓存（路径：C:\Users\sajoy.gradle\caches\7.5\scripts\3d075fs9hjp81ny0sgym4v09w）。

BUG! 在源单元'BuildScript'的'semantic analysis'阶段出现异常：Unsupported class file major version 63

• 建议尝试：
  使用--stacktrace选项获取堆栈跟踪。
  使用--info或--debug选项获取更多日志输出。
  使用--scan选项获取完整分析信息。

BUILD FAILED in 2s
正在运行Gradle任务'assembleRelease'... 3.5s
Gradle任务assembleRelease执行失败，退出码1
进程结束，退出码1

Unsupported class file major version 63 是关键错误——当前使用的Java版本为Java 19（版本号对应63），但项目依赖的Gradle 7.5不支持Java 19，Gradle 7.5最高兼容到Java 17。

方法1：降级Java版本到兼容版本 #

1. 下载并安装Java 17（或Java 8/11这类Gradle 7.5支持的版本）
2. 配置项目Java环境：
   • 打开项目android目录下的gradle.properties，添加/修改：

     org.gradle.java.home=C:\\Program Files\\Java\\jdk-17.x.x
     

   • 或直接将系统环境变量JAVA_HOME设为Java 17的安装路径

方法2：升级Gradle版本适配Java 19 #

1. 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为支持Java 19的Gradle版本（如7.6及以上）：

   distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-all.zip
   

2. 打开android/build.gradle，更新Gradle插件版本匹配新Gradle版本（如Gradle 7.6对应AGP 7.4.0+）：

   dependencies {
       classpath 'com.android.tools.build:gradle:7.4.2'
       // 其他依赖保持不变
   }
   

3. 重新执行flutter build apk

方法3：临时指定构建用Java版本 #

执行构建命令时直接指定Java路径：

flutter build apk -Dorg.gradle.java.home=C:\\Program Files\\Java\\jdk-17.x.x

内容的提问来源于stack exchange，提问作者Salman Ahmed