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

MacOS Catalina 10.15.3下flutter pub get卡顿报错求助

解决MacOS Catalina下flutter pub get TLS/套接字错误的方案

我之前在MacOS Catalina 10.15.3上也碰到过完全一样的问题,给你几个亲测有效的解决办法,按优先级尝试:

1. 切换国内Flutter Pub镜像源(最推荐)

官方源https://pub.dartlang.org在国内访问经常会有网络或TLS兼容问题,切换到国内镜像能直接解决大部分这类问题:

临时生效(仅当前终端会话)

在终端执行以下命令:

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

然后重新执行flutter pub get即可。

永久生效(所有终端会话)

因为Catalina默认使用zsh,所以编辑~/.zshrc文件:

echo 'export PUB_HOSTED_URL=https://pub.flutter-io.cn' >> ~/.zshrc
echo 'export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn' >> ~/.zshrc
source ~/.zshrc

配置完成后,任何终端窗口执行flutter pub get都会自动使用国内镜像。

2. 检查并更新系统SSL/TLS环境

Catalina自带的curl和SSL库可能存在版本兼容问题,导致访问官方源时触发TLS错误:

  1. 用Homebrew更新curl(如果没装Homebrew先安装):
brew install curl
  1. 更新OpenSSL证书:
brew install openssl
brew link openssl --force

⚠️ 注意:--force可能会覆盖系统默认的OpenSSL,如果你有其他依赖系统版本的工具,谨慎操作。

3. 排查网络代理/VPN问题

如果你开启了代理或VPN,可能终端没有正确走代理,或者代理的TLS验证存在问题:

  • 先尝试关闭所有代理/VPN,直接执行flutter pub get测试
  • 如果必须用代理,在终端手动配置代理:
export http_proxy=http://你的代理地址:端口
export https_proxy=http://你的代理地址:端口

4. 手动引入本地包(应急方案)

如果以上方法都不行,可以手动下载包到本地,绕过远程拉取:

  1. 找到launch_review包的最新版本压缩包并下载
  2. 解压后放到项目目录的某个子文件夹(比如./packages/launch_review)
  3. 修改项目的pubspec.yaml:
dependencies:
  launch_review:
    path: ./packages/launch_review

然后执行flutter pub get即可。

额外排查步骤

可以先通过以下命令确认网络问题的具体原因:

# 测试能否连接官方源
ping pub.dartlang.org
# 查看TLS连接的详细日志
curl -v https://pub.dartlang.org

从日志里能判断是证书过期、网络不通还是其他TLS协议兼容问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.06 14:43:13