VSCode搭建Parabol React项目执行yarn db:start命令报错如何解决

报错根因 #

该报错与React框架本身无关，是yarn db:start命令底层调用docker-compose时，无法连接到Docker守护进程导致的，Windows环境下默认通过npipe管道访问Docker服务，报错提示找不到对应的管道文件。

解决方案 #

• 首先检查Docker Desktop运行状态：Windows环境下Docker服务默认不会开机自启，先手动打开Docker Desktop，等待左下角状态标识变为绿色运行中后，再重新执行yarn db:start命令。
• 修复Docker管道环境变量配置：如果Docker已正常启动仍报错，打开当前终端执行$env:DOCKER_HOST = "npipe:////./pipe/docker_engine"临时配置环境变量后重试命令；如果需要永久生效，在Windows系统环境变量中新增变量名DOCKER_HOST，值填写npipe:////./pipe/docker_engine，保存后重启终端即可生效。
• 检查docker-compose版本兼容性：执行docker-compose --version查看本地版本，Parabol项目要求docker-compose版本不低于1.29.0，版本过低时直接升级Docker Desktop即可同步更新docker-compose到匹配版本。
• 确认项目配置文件完整性：检查项目根目录下是否存在docker/dev.yml文件，如果文件缺失说明项目代码拉取不完整，重新拉取全量项目代码后再重试命令。

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