Android Studio从4.0.0升级至4.1.1后Gradle依赖缓存错误如何修复
针对"Gradle's dependency cache may be corrupt"错误的解决步骤
这个报错的核心诱因是跨Android Studio大版本升级后,内置的Gradle包校验规则发生变化,导致原本地缓存的Gradle发行包、依赖包无法通过校验,或是此前网络波动时下载的安装包本身内容不完整,按照以下顺序操作即可快速解决:
- 第一步:清理损坏的本地Gradle缓存
该操作是解决此类报错最高效的手段,直接删除本地失效的缓存文件即可,不会影响项目代码:- 找到本地Gradle存储目录:Windows路径为
C:\Users\<你的本机用户名>\.gradle,macOS/Linux路径为~/.gradle - 优先删除
caches和wrapper/dists两个子文件夹,这部分是存储下载好的Gradle发行包、解析过的依赖的目录,删除后下次同步会重新下载合规文件;如果不想全量删除,可以只删除和项目指定Gradle版本对应的子目录,减少重新下载的流量消耗
- 找到本地Gradle存储目录:Windows路径为
- 第二步:校验项目Gradle Wrapper配置是否和团队约定一致
打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件,核对distributionUrl字段指向的Gradle版本,确认和团队仓库里的配置完全一致,不要因为Android Studio升级自动覆盖了版本配置。常规和Android Studio 4.1.1匹配的Gradle版本配置示例为:distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-bin.zip
注意不要手动在AS设置里把Gradle路径指向本地自定义安装的版本,要严格使用Wrapper指定的版本,保证团队所有人的构建环境一致。 - 第三步:重置Android Studio内部缓存
完成前两步操作后,在Android Studio顶部菜单栏依次操作:- 点击
File > Invalidate Caches / Restart - 在弹出的选项框中选择
Invalidate and Restart,等待AS自动重启
- 点击
- 第四步:触发Gradle全量同步
AS重启完成后,不要直接点击运行或构建按钮,打开右侧边栏的Gradle面板,点击面板顶部的刷新图标,触发全量依赖解析和下载。如果同步过程中网络卡滞,不要强制终止进程,等下载完成的提示出现即可,强制终止会再次生成不完整的损坏缓存。 - 第五步:排除网络导致的包下载损坏问题
如果上述操作完成后还是报相同错误,检查AS的网络代理配置:打开Settings > Appearance & Behavior > System Settings > HTTP Proxy,确认代理配置和当前可用网络匹配,避免因为代理失效导致下载的Gradle包内容截断、校验不通过。
常见避坑提示
- 删除Gradle缓存目录时,不要删除
.gradle目录下的全局自定义配置文件,比如本地配置的Maven仓库镜像地址文件,避免重新下载依赖时因为仓库源不可用导致新的报错 - 不要跳过Wrapper版本校验步骤,私自替换本地Gradle版本进行构建,否则会出现团队成员间依赖解析结果不一致、编译报错的问题
- 如果同步时下载速度过慢,可以临时配置本地的Maven镜像源,不要随意修改Gradle发行包的下载地址指向非官方渠道的包,避免下载到被篡改的安装包
内容的提问来源于stack exchange,提问作者Faithkeeper
相关产品推荐
相关产品推荐

