使用yarn启动React项目时遇Error: read ECONNRESET问题求助

针对性排查与解决步骤 #

1. 清理依赖缓存并重装 #

重新安装依赖时可能存在缓存或文件损坏问题，执行以下命令：

# 清除yarn缓存
yarn cache clean
# 删除旧依赖包和锁文件
rm -rf node_modules yarn.lock
# 重新安装依赖
yarn install

2. 核对Node版本 #

项目两天前可正常运行，重新clone后可能本地Node版本与项目要求不符。检查项目根目录的.nvmrc或package.json内的engines字段，切换对应版本：

# 若使用nvm，自动切换到项目指定版本
nvm use
# 无nvm则手动安装对应版本后重试

3. 调整镜像源与关闭代理 #

ECONNRESET多和网络请求中断有关，先检查yarn镜像源是否正常：

# 切换到官方源
yarn config set registry https://registry.yarnpkg.com
# 或国内稳定镜像源
yarn config set registry https://registry.npmmirror.com

同时关闭本地VPN、代理软件等，避免网络拦截。

4. 强制指定新端口启动 #

虽排查过端口，但可强制指定未使用的端口规避隐性冲突：
修改package.json的scripts字段：

"scripts": {
  "start": "PORT=3001 react-scripts start"
}

执行yarn start重试。

5. 重新拉取完整项目文件 #

重新clone时可能存在文件缺失或损坏，删除现有项目目录后重新拉取：

rm -rf 你的项目文件夹名
git clone <项目仓库地址>
cd 你的项目文件夹名
# 检查文件完整性
git status

6. 重置Mac网络栈 #

Mac系统网络栈异常也可能触发该错误，执行以下命令重置：

# 刷新DNS缓存
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
# 重置网络接口
sudo ifconfig en0 down; sudo ifconfig en0 up

重启终端后再尝试启动项目。

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