You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter项目创建遇socket错误,求原因及永久解决方案

错误原因
  • 网络访问受限:flutter create创建项目时会自动从pub.dev拉取flutter_lints等依赖包,若网络不稳定、存在区域访问限制或pub.dev服务器临时故障,就会触发socket连接错误。
  • 启动锁未完全释放:日志里提到的“等待另一个flutter命令释放启动锁”,说明之前的Flutter进程没有彻底终止,导致后续命令的网络请求流程被阻塞。
  • 本地pub缓存损坏:本地pub缓存的依赖索引或数据出现损坏,创建项目时无法正常解析flutter_lints的包信息,引发错误。
永久解决办法
  • 配置国内pub镜像源:
    终端执行以下命令切换到国内镜像,规避网络访问问题:
    flutter config --set pub-hosted-url https://pub.flutter-io.cn
    flutter config --set flutter-storage-base-url https://storage.flutter-io.cn
    
    配置完成后重启VS Code再创建新项目。
  • 清理并修复pub缓存:
    执行命令清理项目缓存并修复损坏的pub缓存数据:
    flutter clean
    flutter pub cache repair
    
  • 终止残留Flutter进程:
    打开任务管理器(Windows)或活动监视器(Mac),结束所有flutter、dart相关进程后,重新尝试创建项目。
  • 升级Flutter到稳定版:
    旧版本Flutter可能存在依赖解析的bug,执行升级命令更新到最新稳定版:
    flutter upgrade
    

内容的提问来源于stack exchange,提问作者Shah Nawaz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.27 17:15:57