Flutter 3.16执行dart pub add报错，求排查全局问题及解决方法

问题情况 #

• 升级至Flutter 3.16版本后，新项目执行dart pub add <package_name>无法安装任何包
• 旧项目执行相同命令也出现相同错误
• 已尝试以管理员身份运行终端，问题未解决

错误信息 #

英文原版：

Got socket error trying to find package firebase_messaging_platform_interface at https://pub.dev.
exit code 69

中文翻译：

在https://pub.dev查找包firebase_messaging_platform_interface时遇到套接字错误。
退出代码69

解决方法 #

• 检查网络连通性：确认本地网络能正常访问pub.dev，可尝试切换网络（如手机热点），排查防火墙、代理是否拦截了pub的请求
• 切换国内pub镜像源：如果是网络访问pub.dev不稳定导致，可切换国内镜像：
  执行以下命令一键切换：

  dart pub global activate pub_replacer
  pub_replacer use taobao
  

  或手动设置环境变量（Windows设置系统环境变量，Linux/macOS在终端执行）：

  # Linux/macOS
  export PUB_HOSTED_URL=https://pub.flutter-io.cn
  export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
  
  # Windows 命令行
  set PUB_HOSTED_URL=https://pub.flutter-io.cn
  set FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
  

• 清除Pub缓存：清理本地缓存后重新拉取包，执行命令：

  dart pub cache clean
  

• 指定兼容版本：部分包可能暂未适配Flutter 3.16，可在pubspec.yaml中手动指定该包的兼容版本，例如：

  dependencies:
    firebase_messaging_platform_interface: ^4.5.1
  

  版本号可参考pub.dev上该包的版本列表选择适配3.16的版本
• 检查并修复Flutter环境：执行flutter doctor检查环境问题，根据提示修复所有异常；或重新执行flutter upgrade确保升级过程完整

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