Flutter/Vscode调试时Gradle-7.3.0下载失败问题求助

问题根源 #

错误提示明确是找不到Gradle 7.3.0的安装包下载链接，本质是你的网络环境无法正常访问Gradle官方服务器，而你朋友的电脑已经缓存过这个包或者网络环境能正常下载。

可行解决方案 #

1. 手动下载并放置Gradle包 #

• 自行获取gradle-7.3.0-all.zip安装包
• 找到项目里的.gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl指向的是这个版本
• 把下载好的zip放到本地Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\wrapper\dists\gradle-7.3.0-all\<自动生成的随机文件夹>
  • macOS/Linux：~/.gradle/wrapper/dists/gradle-7.3.0-all/<自动生成的随机文件夹>
  • 不确定文件夹路径的话，先运行一次项目触发下载流程，系统会生成对应的目录结构，再把zip放进去即可

2. 替换Gradle国内镜像源 #

• 打开项目的android/build.gradle文件，找到buildscript和allprojects块里的repositories，将原有地址替换为国内Maven镜像（比如阿里云、腾讯云提供的公开镜像）
• 同时可以把gradle-wrapper.properties里的distributionUrl替换为国内镜像站点提供的对应Gradle包地址

3. 检查网络环境 #

• 关闭正在使用的代理工具，或者确认代理配置能正常访问Gradle官方地址
• 排查防火墙、安全软件是否拦截了Gradle的下载请求

4. 切换本地已兼容的Gradle版本 #

如果你本地已经安装了其他能兼容项目的Gradle版本，直接修改gradle-wrapper.properties里的distributionUrl为对应版本的地址即可。

内容的提问来源于stack exchange，提问作者김도윤