升级Flutter 2.5后执行flutter pub get报错无法运行如何解决？

产生原因 #

• 官方pub源服务器位于境外，国内网络直接访问时容易出现DNS解析失败、连接超时的问题，Flutter 2.5版本默认未适配国内镜像源，触发概率更高。
• 本地网络配置了代理但未覆盖pub相关请求、或hosts文件中存在pub.dartlang.org的错误指向，也会导致URL无法解析。
• 系统当前使用的DNS服务器故障，无法正常解析pub域名的IP地址。

解决方法 #

方案1：配置国内公开Flutter镜像源（优先级最高） #

根据你使用的操作系统做对应配置即可：

• Windows系统
  新增两个系统环境变量：

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

  配置完成后重启终端或IDE，重新执行flutter pub get。
• macOS/Linux系统
  打开当前用户的shell配置文件（如使用bash则为_{/.bashrc，使用zsh则为}/.zshrc），在文件末尾添加两行内容：

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

  保存后执行source ~/.zshrc（对应你使用的配置文件路径）使配置生效，再重新执行flutter pub get。

方案2：排查本地网络配置 #

• 若本地开启了代理，确认代理规则已放行pub相关域名的请求，或临时关闭代理后重试。
• 检查系统hosts文件中是否存在pub.dartlang.org的绑定配置，若有错误指向可删除对应条目后重试。
• 可将当前网络的DNS服务器替换为公共DNS（如阿里云223.5.5.5、腾讯云119.29.29.29），清空DNS缓存后再重试。

内容的提问来源于stack exchange，提问作者Rehan Raza