Flutter应用构建卡在assembleDebug Gradle ZipException报错求助

故障原因 #

报错java.util.zip.ZipException: error in opening zip file为Gradle Wrapper依赖的压缩包损坏导致的解压失败，触发原因为跨设备挂载旧硬盘后原有缓存的Gradle压缩包文件损坏，或是新环境下首次拉取包时网络波动导致下载不完整。

解决步骤 #

• 清理损坏的Gradle缓存包
  根据操作系统进入对应Gradle缓存目录：
  • Windows：打开资源管理器进入%USERPROFILE%\.gradle\wrapper\dists
  • macOS/Linux：在终端进入~/.gradle/wrapper/dists
    找到名为gradle-6.7-all的文件夹，直接删除整个文件夹。
• （可选）替换Gradle镜像源
  若访问Gradle官方源速度较慢，可打开项目下android/gradle/wrapper/gradle-wrapper.properties文件，将distributionUrl参数替换为国内镜像地址：

  distributionUrl=https\://mirrors.tencent.com/gradle/gradle-6.7-all.zip
  

• 重新构建项目
  回到Flutter项目根目录，依次执行以下命令：

  flutter clean
  flutter pub get
  

  之后正常运行flutter run即可，Gradle会自动重新下载完整的对应版本压缩包，解压报错会消失。

内容的提问来源于stack exchange，提问作者Atuoha Anthony