VSCode运行Flutter代码报Gradle zip END header not found错误如何解决?
问题根因
java.util.zip.ZipException: zip END header not found错误核心原因是项目使用的Gradle发行版压缩包下载不完整、文件损坏,Gradle wrapper工具无法正常解压该文件导致编译终止。
解决步骤
- 第一步:删除损坏的Gradle缓存文件
前往对应系统的Gradle缓存目录,删除wrapper/dists下对应版本的Gradle文件夹:- Windows系统路径:
C:\Users\你的系统用户名\.gradle\wrapper\dists - macOS/Linux系统路径:
~/.gradle/wrapper/dists
- Windows系统路径:
- 第二步:清理Flutter项目本地缓存
在Flutter项目根目录执行命令:flutter clean - 第三步:重新运行项目
正常启动Flutter项目,工具会自动重新下载完整的Gradle发行包,等待下载完成即可正常编译运行。
异常情况排查
如果操作后依然报错,可以额外检查两项配置:
- 打开项目下
android/gradle/wrapper/gradle-wrapper.properties文件,确认distributionUrl参数的地址可正常访问,网络条件受限的话可以替换为国内公共镜像源地址。 - 检查本地网络稳定性,避免下载过程中断网、限速导致压缩包再次损坏。
内容的提问来源于stack exchange,提问作者myself_rana.raj
相关产品推荐
相关产品推荐

