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

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.28 01:09:58