Android Studio新建Flutter项目运行报Connection refused错误
问题核心原因
报错栈关键异常为java.net.ConnectException: Connection refused,触发位置为Gradle Wrapper的下载逻辑,本质是Gradle无法连通默认的官方发行包服务器,拉取gradle-7.4-all依赖包失败。删除本地已缓存的gradle-7.4-all文件夹会强制触发重新下载流程,无法解决网络连通层面的故障。
排查解决步骤
- 检查Gradle Wrapper下载地址配置
打开项目路径下的android/gradle/wrapper/gradle-wrapper.properties文件,找到distributionUrl配置项,默认值指向Gradle官方源,国内网络环境下极易出现连接失败问题。 - 替换Gradle发行包下载源为国内可访问镜像
将distributionUrl的官方地址替换为国内镜像源的对应Gradle 7.4版本地址,保存文件。 - 配置项目级Maven仓库镜像,避免后续安卓依赖拉取失败
打开项目路径下的android/build.gradle文件,修改buildscript和allprojects两个代码块下的repositories配置,优先配置国内镜像源,参考配置如下:
repositories { maven { url 'https://mirrors.tencent.com/nexus/repository/maven-public/' } maven { url 'https://mirrors.aliyun.com/repository/google/' } maven { url 'https://mirrors.aliyun.com/repository/central/' } google() mavenCentral() }
- 排查代理配置冲突
如果本地开启了系统代理,打开android/gradle.properties文件,确认代理端口、IP配置和本地代理参数一致;如果未开启代理,直接删除文件中所有systemProp.http.proxy、systemProp.https.proxy开头的配置项,错误的代理配置是触发连接拒绝的常见原因。 - 清理缓存重新构建
在项目根目录依次执行以下命令,清理旧的构建缓存后重新运行:
flutter clean flutter pub get flutter run
内容的提问来源于stack exchange,提问作者Serdar
相关产品推荐
相关产品推荐

