Flutter启动失败出现连接超时异常如何解决

在Flutter项目启动时遇到连接超时异常，错误信息如下：SocketException: Connection timed out。已尝试过更换网络环境、关闭防火墙和重启IDE，但问题依旧。具体表现为运行flutter run命令后卡在"Running Gradle task ‘assembleDebug’…"阶段，最终报连接超时。请问这可能是什么原因导致的？是否需要配置特殊的代理设置或修改gradle配置？目前使用的Flutter版本是3.13.0，Gradle版本7.5。

2 回复

检查网络连接，确保能访问Flutter资源。可尝试更换镜像源或使用VPN。

更多关于Flutter启动失败出现连接超时异常如何解决的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


Flutter启动时出现连接超时异常，通常与网络连接、依赖下载或代理设置有关。以下是常见解决方案：

1. 检查网络连接

确保网络稳定，尝试访问 https://pub.dev 和 https://storage.googleapis.com（Flutter依赖的主要源）。

2. 配置国内镜像（适用于中国大陆用户）

在终端执行以下命令设置环境变量：

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

或永久添加到 ~/.bashrc（Linux/macOS）或环境变量（Windows）。

3. 检查代理设置

若使用代理，确保Flutter能识别系统代理：

  • 设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量。
  • 或在Flutter项目根目录的 android/gradle.properties 中添加：
systemProp.http.proxyHost=your-proxy-host
systemProp.http.proxyPort=your-proxy-port
systemProp.https.proxyHost=your-proxy-host
systemProp.https.proxyPort=your-proxy-port

4. 清理并重试

运行以下命令清理缓存并重新获取依赖：

flutter clean
flutter pub get

5. 禁用IPv6（如适用）

某些网络环境下IPv6可能导致超时，可尝试禁用：

  • 在系统网络设置中暂时关闭IPv6。

6. 检查防火墙/安全软件

确保防火墙或安全软件未阻止Flutter的网络访问。

7. 手动下载依赖

若持续失败，可手动下载依赖（如Gradle）并放置到缓存目录（路径见Flutter错误日志）。

8. 更新Flutter

确保使用最新稳定版：

flutter upgrade

执行上述步骤后，重启IDE或终端重试。问题通常能通过镜像或代理解决。

回到顶部