You need to enable JavaScript to run this app. Flutter 安装 Cloud Firestore SDK 时 flutter pub get 报 Socket 错误
优惠活动
大模型
产品
解决方案
定价
更多

Flutter 安装 Cloud Firestore SDK 时 flutter pub get 报 Socket 错误

问题根因

执行flutter pub get时触发Socket连接错误、反复重试失败的核心原因是:Flutter 默认的包拉取源指向境外站点,国内网络环境下直连极易出现连接超时、服务不可达的问题,和pubspec.yaml中编写的依赖版本本身无直接关联。

解决步骤
  • 临时切换Pub拉取源
    无需修改项目内代码,在执行拉取命令的终端窗口中,先设置国内镜像环境变量,再重新执行拉取命令即可:

    • macOS/Linux 终端依次执行:
      export PUB_HOSTED_URL=https://pub.flutter-io.cn
      export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
    • Windows PowerShell 依次执行:
      $env:PUB_HOSTED_URL = "https://pub.flutter-io.cn"
      $env:FLUTTER_STORAGE_BASE_URL = "https://storage.flutter-io.cn"
      变量设置完成后,在项目根目录重新运行flutter pub get即可正常拉取依赖。
  • 永久配置Pub源(免除重复设置操作)
    将上述两个环境变量写入常用终端的全局配置文件(zsh对应~/.zshrc、bash对应~/.bash_profile、PowerShell对应用户配置文件),保存后执行对应重载命令(或重启终端)即可全局生效,后续所有Flutter项目的包拉取都会默认走国内镜像,不会再出现境外源连接失败的问题。

  • 拉取阶段的版本兼容提示
    配置中写入的firebase_auth: ^0.20.1、cloud_firestore: ^0.16.0+1、firebase_core: ^0.7.0属于FlutterFire框架的旧版本,仅适配Flutter 2.0~2.2区间的SDK版本。如果源切换成功后出现版本冲突类提示,需根据本地安装的Flutter SDK版本匹配对应兼容的依赖版本,不要盲目升级到最新版Firebase依赖,避免旧项目出现适配报错。


内容的提问来源于stack exchange,提问作者Sarah Bensalem

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.02 09:06:11