如何解决Flutter SDK中找不到integration_test包的报错问题

一、解决integration_test包不存在的版本/配置问题 #

• 先核对本地Flutter SDK版本：执行flutter --version，integration_test是Flutter 1.20.0版本之后才内置到官方SDK的包，若本地版本过低，直接声明SDK来源的依赖必然找不到。
  • 低版本SDK的处理选项：要么升级到Flutter 2.10及以上稳定版，要么先注释掉pubspec.yaml中integration_test的依赖，临时跳过该包的拉取。
• 修正pubspec.yaml中的依赖声明格式：
  这是开发者从官方模板复制代码时最高发的错误诱因：不少人写依赖时格式写错，把SDK内置包写成了普通远端依赖，正确的声明格式为：

  dev_dependencies:
    integration_test:
      sdk: flutter
  

  禁止写成integration_test: any这类裸声明，该写法会让Pub默认从远端仓库搜索包，无法匹配到SDK内置源，直接触发“包不存在”的报错。
• 清除本地损坏的依赖缓存：
  旧的缓存锁文件很容易在SDK升级后出现解析冲突，执行以下操作删除损坏的缓存，避免旧文件干扰新版本解析：
  • 删除项目根目录下的pubspec.lock文件
  • 删除项目根目录下的.dart_tool文件夹
  • 执行flutter clean清理全量编译缓存

二、解决server unavailable的连接重试报错 #

该报错本质是本地网络无法正常连接Pub官方源，和SDK本身的包解析问题没有直接关联：

• 配置国内镜像源替代境外直连源，避免连接超时触发无限重试：
  macOS/Linux 临时配置环境变量后重新执行拉取：

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

  Windows环境直接在系统环境变量中添加上述两个同名变量即可生效。
• 排查本地网络拦截规则：关闭会拦截Pub域名的全局代理、VPN直连模式，避免请求被拦截导致的服务不可用提示。

三、修复后的验证流程 #

按顺序执行以下命令确认问题解决：

1. 执行flutter pub get重新拉取依赖
2. 若仍有版本冲突，执行flutter pub outdated查看所有依赖的兼容区间，把和当前SDK不匹配的依赖版本调整到支持范围内。

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