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

Flutter项目在Android Studio运行失败,报ZipException错误求助

解决Flutter运行时Gradle Zip解压错误(zip END header not found)

这个错误是Gradle wrapper解压Gradle分发包时检测到zip文件损坏导致的,和Flutter SDK本身无关,因此重装Flutter无法解决问题,以下是针对性的解决步骤:

  • 清理本地Gradle缓存
    找到Gradle缓存目录并删除其中内容:

    • Windows:C:\Users\<你的用户名>\.gradle\caches
    • macOS/Linux:~/.gradle/caches
      可以直接删除整个caches文件夹,或者只删除与报错Gradle版本相关的子目录。
  • 修复项目中的Gradle Wrapper文件
    进入Flutter项目的android目录,删除以下文件:

    • gradle/wrapper/gradle-wrapper.jar
    • gradle/wrapper/gradle-wrapper.properties
      之后可以从一个正常运行的Flutter项目中复制对应的这两个文件,或者手动生成:
      打开终端进入项目的android目录,执行命令(替换为稳定的Gradle版本,比如7.4):
    gradle wrapper --gradle-version 7.4
    
  • 手动下载Gradle分发包
    查看gradle-wrapper.properties中的distributionUrl(比如https://services.gradle.org/distributions/gradle-7.4-bin.zip),手动下载该zip包,放到Gradle的wrapper/dists目录下(例如Windows路径:C:\Users\<用户名>\.gradle\wrapper\dists\gradle-7.4-bin\<随机字符目录>),无需解压,Gradle会自动识别使用。

  • 检查Android Studio Gradle配置
    打开Android Studio,进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle,确保选择Use Gradle from: 'gradle-wrapper.properties' file,避免使用本地损坏的Gradle版本。

内容的提问来源于stack exchange,提问作者pooria rm

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.21 16:40:02