Android Studio无法构建Kotlin项目，Gradle缓存读取失败求助

• 彻底清理全局Gradle缓存
  项目内的.gradle目录只是局部缓存，全局Gradle缓存损坏才是核心问题。找到全局缓存目录：

  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • macOS/Linux：~/.gradle/caches
    直接删除整个caches文件夹，这会强制Gradle重新生成所有缓存文件。

• 强制刷新依赖并重新构建
  在项目根目录打开终端，执行对应系统的命令：

  # macOS/Linux
  ./gradlew clean build --refresh-dependencies
  
  # Windows
  gradlew clean build --refresh-dependencies
  

  该命令会清理项目构建产物，同时忽略本地缓存的依赖，重新从仓库下载所有需要的依赖包。

• 核对Gradle版本兼容性
  打开项目根目录的build.gradle（Project层级），检查com.android.tools.build:gradle插件版本和distributionUrl指向的Gradle发行版是否匹配。比如插件版本7.4.2对应Gradle版本7.5，版本不匹配极易引发缓存解析异常。可以尝试回退到之前项目正常运行时的Gradle和插件版本。

• 排查系统级缓存干扰

  • Windows用户：检查杀毒软件是否误删了Gradle缓存文件，必要时将.gradle目录加入杀毒软件白名单。
  • macOS用户：执行chmod -R 755 ~/.gradle修复缓存目录的权限问题。
  • 也可以通过修改gradle.properties文件更换缓存路径，添加如下配置：

    org.gradle.caching.dir=/自定义的新缓存路径
    

  让Gradle使用全新的缓存位置，彻底避开损坏的旧缓存。

• 验证JDK版本兼容性
  执行java -version检查当前使用的JDK版本，确保其符合Gradle版本要求：比如Gradle 7.x及以上需要JDK 11或更高版本。如果版本不匹配，切换到兼容的JDK环境后再尝试构建。

内容的提问来源于stack exchange，提问作者Hein Bol