You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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
  • 第二步:清理Flutter项目本地缓存
    在Flutter项目根目录执行命令:
    flutter clean
    
  • 第三步:重新运行项目
    正常启动Flutter项目,工具会自动重新下载完整的Gradle发行包,等待下载完成即可正常编译运行。
异常情况排查

如果操作后依然报错,可以额外检查两项配置:

  • 打开项目下android/gradle/wrapper/gradle-wrapper.properties文件,确认distributionUrl参数的地址可正常访问,网络条件受限的话可以替换为国内公共镜像源地址。
  • 检查本地网络稳定性,避免下载过程中断网、限速导致压缩包再次损坏。

内容的提问来源于stack exchange,提问作者myself_rana.raj

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.26 20:54:00