Flutter运行时Gradle下载构件报错ZipException该如何解决？

问题根因 #

本次报错和你编写的Dart业务代码完全无关，java.util.zip.ZipException: error in opening zip file是Gradle构建工具的Wrapper压缩包下载不完整或损坏导致的，你之前能正常运行的旧项目也报相同错误，说明问题出在全局Gradle缓存，而非当前项目的代码或配置。

解决方案 #

按以下步骤操作即可修复：

• 第一步：清理全局损坏的Gradle缓存
  Windows系统进入路径 C:\Users\你的系统用户名\.gradle\wrapper\dists，删除该目录下所有文件夹，这些都是下载失败的损坏Gradle压缩包缓存；
  macOS/Linux系统进入路径 ~/.gradle/wrapper/dists，同样删除该目录下的全部内容。
• 第二步：（可选，避免后续网络问题导致下载失败）配置国内Gradle镜像
  打开当前项目android/build.gradle文件，将repositories节点下默认的google()、jcenter()替换为国内公开镜像源即可。
  也可以修改项目android/gradle/wrapper/gradle-wrapper.properties文件中的distributionUrl参数，替换为国内镜像站的Gradle包地址，提升下载成功率。
• 第三步：重新启动项目
  先在项目根目录执行flutter clean清理项目本地缓存，再执行flutter run启动应用，工具会自动重新下载完整的Gradle构建包。

补充说明：你提交的Dart代码本身没有语法错误，不会触发本次构建报错。待构建成功后如果发现页面布局异常，调整外层Scaffold和MainContent组件内嵌套的Scaffold逻辑即可。

内容的提问来源于stack exchange，提问作者Fathi Draws