克隆GitHub Flutter项目运行报错：设置类缓存无法打开及语义分析异常

核心原因 #

报错Unsupported class file major version 61是因为Java 17版本和项目使用的Gradle版本不兼容——旧版Gradle不支持Java 17；Could not open settings generic class cache则多是缓存权限异常或缓存文件损坏导致。

具体修复步骤 #

1. 匹配Java与Gradle版本 #

• 打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件，查看distributionUrl对应的Gradle版本：

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

• 对照版本适配规则调整：
  • Gradle 7.0及以上版本支持Java 17
  • Gradle 6.7-6.9支持Java 16
  • Gradle 6.1-6.6支持Java 15
  • Gradle 5.4-6.0支持Java 14
    要么升级Gradle到7.0+，要么降级Java到对应支持的版本（比如Java 11）。

2. 清理Gradle缓存 #

• 删除本地Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • Mac/Linux：~/.gradle/caches
• 重新运行项目，Gradle会自动重建缓存。

3. 配置项目Java版本（可选） #

在项目的android/build.gradle文件中指定Java版本，确保和本地安装的版本一致：

buildscript {
    ext {
        javaVersion = '11' // 或17，根据实际配置调整
    }
    // ...其他配置
}

tasks.withType(JavaCompile) {
    sourceCompatibility = javaVersion
    targetCompatibility = javaVersion
}

4. 检查Flutter环境完整性 #

执行以下命令检查环境配置，按照提示修复缺失的依赖或配置：

flutter doctor

内容的提问来源于stack exchange，提问作者Mohammad alqannas