HOME> 东京世界杯> 【错误记录】Flutter 报错 Downloading the Dart SDK using the BITS service failed, retrying with WebRequest...

【错误记录】Flutter 报错 Downloading the Dart SDK using the BITS service failed, retrying with WebRequest...

东京世界杯 2025-12-16 22:06:55
文章目录 一、 报错信息二、解决方案 ( 检查镜像地址环境变量设置 )1、检查镜像地址环境变量设置 ( 错误方案 没有解决问题 )2、尝试使用官方...

文章目录

一、 报错信息二、解决方案 ( 检查镜像地址环境变量设置 )1、检查镜像地址环境变量设置 ( 错误方案 没有解决问题 )2、尝试使用官方地址

三、总结1、官方镜像 ( 推荐方案 )2、国内镜像 ( 备选方案 )

官方推荐的中国镜像 : https://flutter.dev/community/china

问题原因找到 , 上海交通大学的 Flutter 镜像失效导致 , 或者暂时性失效 ; ( 反正今天是没用上 )

Shanghai Jiaotong University Linux User Group

FLUTTER_STORAGE_BASE_URL: https://mirrors.sjtug.sjtu.edu.cn/

PUB_HOSTED_URL: https://dart-pub.mirrors.sjtug.sjtu.edu.cn/

使用官方镜像后 , 执行 flutter doctor 命令成功 ;

PUB_HOSTED_URL : https://pub.flutter-io.cn

FLUTTER_STORAGE_BASE_URL : https://storage.flutter-io.cn

镜像需要设置到环境变量中 ;

一、 报错信息

执行 flutter doctor 命令后 , 出现如下报错信息 ;

报错信息 :

C:\Users\octop>flutter doctor

Checking Dart SDK version...

Downloading Dart SDK from Flutter engine 2f0af3715217a0c2ada72c717d4ed9178d68f6ed...

Downloading the Dart SDK using the BITS service failed, retrying with WebRequest...

Invoke-WebRequest : 404 Not Found

所在位置 Y:\001_DevelopTools\010_Flutter\flutter\bin\internal\update_dart_sdk.ps1:70 字符: 5 +

Invoke-WebRequest -Uri $dartSdkUrl -OutFile $dartSdkZip +

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +

CategoryInfo : InvalidOperation: (System.Net.HttpWebRequest:HttpWebRequest) [Invoke-WebRequest],WebExce ption + FullyQualifiedErrorId : WebCmdletWebResponseException,Microsoft.PowerShell.Commands.InvokeWebRequestCommand

Error: Unable to update Dart SDK. Retrying...

等待 0 秒,按 CTRL+C 退出 ...

二、解决方案 ( 检查镜像地址环境变量设置 )

1、检查镜像地址环境变量设置 ( 错误方案 没有解决问题 )

Dart SDK 下载错误 , 肯定是没有访问到 Dart SDK 的下载地址 ;

之前在 【Flutter】Flutter 开发环境搭建 ( Android Studio 下 Flutter / Dart 插件安装 | Flutter SDK 安装 | 环境变量配置 | 开发环境检查 ) 五、设置 Flutter 网络镜像 ( 中国国内推荐设置 ) 步骤中设置了网络镜像环境变量 , 检查下面的两个镜像是否设置正确 ;

中国国内建议使用镜像 ( 官方网站推荐 ) :

FLUTTER_STORAGE_BASE_URL: https://mirrors.sjtug.sjtu.edu.cn/

PUB_HOSTED_URL: https://dart-pub.mirrors.sjtug.sjtu.edu.cn/

Flutter 下载没有问题 , 说明 Flutter 镜像设置正确 ;

Dart SDK 下载出现问题 , 说明 Dart SDK 镜像设置错误 , 或者没有设置该环境变量 ;

设置之后还是不行 , 上海交通大学的镜像应该是挂了 , 使用官方镜像 ;

2、尝试使用官方地址

上述镜像无法使用 , 现将镜像地址设置为官方地址 ;

PUB_HOSTED_URL : https://pub.flutter-io.cn

FLUTTER_STORAGE_BASE_URL : https://storage.flutter-io.cn

使用了官方镜像之后 , 该问题成功解决 ;

执行 flutter doctor 之后 , 成功下载相关文件 ;

三、总结

上述 Flutter 或 Dart 下载问题 , 如果环境变量设置错误 , 就会导致上述问题 ;

1、官方镜像 ( 推荐方案 )

如果出现问题 , 那么尝试使用官方的下载地址 : 注意国内使用该地址需要 Fan Q ;

PUB_HOSTED_URL : https://pub.flutter-io.cn

FLUTTER_STORAGE_BASE_URL : https://storage.flutter-io.cn

Windows 中设置环境变量 : 右键点击 " 我的电脑 / 此电脑 " -> 属性 -> 高级系统设置 -> 高级 -> 环境变量 ;

MAC 中设置环境变量 : 在命令行使用 export 命令 ;

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

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

2、国内镜像 ( 备选方案 )

刚测试了下 都挂了 , 没法用 ;

中国国内使用镜像 1 ( 上海交通大学 ) :

FLUTTER_STORAGE_BASE_URL: https://mirrors.sjtug.sjtu.edu.cn/

PUB_HOSTED_URL: https://dart-pub.mirrors.sjtug.sjtu.edu.cn/

中国国内使用镜像 2 ( Flutter 社区 ) :

FLUTTER_STORAGE_BASE_URL: https://storage.flutter-io.cn

PUB_HOSTED_URL: https://pub.flutter-io.cn

中国国内使用镜像 3 ( 清华大学 TUNA 协会 ) :

FLUTTER_STORAGE_BASE_URL: https://mirrors.tuna.tsinghua.edu.cn/flutter

PUB_HOSTED_URL: https://mirrors.tuna.tsinghua.edu.cn/dart-pub

Windows 中设置环境变量 : 右键点击 " 我的电脑 / 此电脑 " -> 属性 -> 高级系统设置 -> 高级 -> 环境变量 ;

MAC 中设置环境变量 : 在命令行使用 export 命令 ;

export PUB_HOSTED_URL=https://mirrors.sjtug.sjtu.edu.cn

export FLUTTER_STORAGE_BASE_URL=https://dart-pub.mirrors.sjtug.sjtu.edu.cn

上述两个镜像设置正确 , 基本就不会出现问题 ;