Flutter升级至最新版后执行flutter pub get拉取依赖报错求助

高频异常根因 #

• 依赖版本约束与新版Flutter SDK不兼容：升级Flutter后Dart SDK版本会同步提升，若现有pubspec.yaml中配置的依赖版本标注了过高的SDK版本上限，pub在解析依赖树时会触发版本冲突校验失败，这是升级场景下占比最高的报错来源
• 本地pub缓存文件损坏：升级Flutter过程中未同步清理的旧缓存、残留的损坏依赖索引，会阻塞新版本的依赖拉取流程
• 网络连通性异常：默认pub源网络不稳定时，会出现元数据获取失败、拉取超时类报错
• pubspec.yaml配置格式错误：缩进不规范、依赖版本标识不符合pub语法要求、SDK标识漏写，会导致配置文件解析直接中断

可落地修复步骤 #

1. 清理本地无效缓存与旧解析记录
   • 执行命令清理全量pub缓存：flutter pub cache clean
   • 删除项目根目录下的 .dart_tool 隐藏文件夹、pubspec.lock 锁文件，移除旧的依赖解析记录避免干扰
   • 执行环境校验命令：flutter doctor -v 确认当前Flutter SDK路径配置正常，Dart版本与SDK完全匹配
2. 适配依赖版本解决冲突
   • 对照当前Flutter版本对应的Dart SDK版本要求，逐一核对pubspec.yaml中的依赖版本约束
   • 对存在版本冲突的依赖，优先升级到适配当前Flutter版本的插件最新正式版，将固定版本约束调整为兼容范围（如将1.2.3调整为^1.2.3匹配同大版本的兼容更新）
   • 针对长期未维护、不匹配新SDK的旧插件，可在pubspec.yaml的dependency_overrides字段临时指定兼容版本或本地插件路径，快速打通依赖解析流程
3. 优化拉取链路稳定性
   • 若存在默认pub源访问不稳定的情况，可配置稳定的公共镜像地址作为pub源与flutter storage源，重新执行拉取命令
   • 执行带详细日志的拉取命令：flutter pub get --verbose，从日志中定位具体是哪个依赖、哪个流程环节出现异常，避免盲目排查

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