Android Studio构建时出现Gradle损坏错误如何排查解决

该报错本质是Gradle本地缓存的B树索引块损坏无法被正常读取，常见触发场景如下：

• 构建流程被强制中断：Gradle写入缓存文件过程中，出现Android Studio强退、电脑断电/蓝屏、手动杀掉Gradle进程等情况，导致缓存文件写入不完整
• 磁盘IO异常：C盘存在逻辑坏道、磁盘读写时出现临时故障，导致缓存文件存储的数据出错
• 版本切换残留：升级/降级Gradle、Android Gradle Plugin(AGP)版本时，旧版本生成的缓存没有被正常兼容，新版本读取时识别为损坏
• 安全软件拦截：杀毒软件、系统安全工具在Gradle写缓存时锁定文件、执行扫描，打断正常写入流程，导致文件结构损坏

按照操作复杂度从低到高依次尝试即可：

• 定向删除损坏缓存文件
  直接定位到报错提示的路径 C:\Users\zulqa\.gradle\caches\journal-1\，删除路径下的file-access.bin文件后重新构建，Gradle会自动重新生成完好的对应缓存文件，这是处理单文件缓存损坏最快的方案。
• 全量清理Gradle缓存目录
  如果删除单文件后依旧报其他缓存损坏错误，直接关闭Android Studio，进入C:\Users\zulqa\.gradle\路径，删除整个caches文件夹后重启IDE触发构建。该操作不会修改任何项目源码，仅会让首次构建重新下载依赖、重建缓存，耗时依网络情况略有增加。
• 命令行强制刷新构建
  若IDE内触发构建依旧异常，打开Android Studio底部的Terminal面板（确保当前路径为项目根目录），执行如下命令强制清理构建产物、刷新所有依赖并重建缓存：

  gradlew clean build --refresh-dependencies
  

• 排查反复触发损坏的根因
  如果完成上述操作后仍频繁出现同类缓存损坏问题，逐一排查以下环境问题：
  • 将C:\Users\zulqa\.gradle\目录加入本地杀毒软件的扫描白名单，避免缓存写入过程被安全工具拦截锁定
  • 以管理员身份打开命令提示符，执行chkdsk C: /f扫描修复C盘的逻辑磁盘错误，排除磁盘坏道导致的文件写入异常
  • 构建过程中不要强制关闭Android Studio、不要手动结束Gradle后台进程，避免写入中断

内容的提问来源于stack exchange，提问作者Beast π Jawad