Dart项目执行pub get返回exit code 69错误原因咨询
2026-8-28
pub get 报 Connection closed before full header was received exit code 69 原因说明 这个报错属于pub包管理器的网络类故障，退出码69对应「远程服务连接异常」分类，和本地pubspec.yaml的配置语法无关——从贴出的配置截图看，依赖声明格式完全合法，问题出在依赖拉取的网络链路环节。
常见触发原因
- 依赖源访问受限：国内网络直连官方pub.dev源时，常因运营商路由拦截、国际链路波动导致连接被中途重置，还没收到完整响应头连接就断开
- 镜像源配置异常：如果之前手动配置过第三方pub镜像，对应镜像站服务下线、HTTPS证书配置错误、域名解析异常，都会触发该错误
- 本地代理/防火墙拦截：系统开了代理但终端未继承代理配置、代理节点不稳定、公司/校园网防火墙拦截了依赖源的HTTPS请求，会导致半连接断开
- 临时服务波动：使用的依赖源刚好处于临时运维、服务不可用的窗口期，重试时可能自行恢复
可直接落地的修复方案
- 先检查当前生效的pub源地址，终端执行
pub env查看PUB_HOSTED_URL对应的配置值，先在浏览器打开该地址确认能正常访问 - 国内用户优先替换为稳定的国内镜像，根据使用的终端执行对应命令设置环境变量后重试：
- Windows CMD：
set PUB_HOSTED_URL=https://pub.flutter-io.cn - Windows PowerShell：
$env:PUB_HOSTED_URL="https://pub.flutter-io.cn" - Mac/Linux：
export PUB_HOSTED_URL=https://pub.flutter-io.cn
设置完成后重新执行pub get即可
- Windows CMD：
- 如果本地开了网络代理，先确认终端已正确配置
HTTP_PROXY/HTTPS_PROXY环境变量，也可临时关闭代理重试排除代理拦截问题 - 以上操作无效时，执行
pub cache repair修复本地损坏的pub缓存文件，再重新拉取依赖
对应报错现场截图：
对应pubspec.yaml配置截图：
内容的提问来源于stack exchange，提问作者Serdar
相关产品推荐
相关产品推荐
