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

使用create-react-app创建项目时报npm ERR_SOCKET_TIMEOUT错误如何解决?

报错原因

该错误为npm拉取依赖资源时网络超时触发,本质是网络连通性问题,和create-react-app工具本身没有关联,官方报错提示也明确了大概率是代理配置异常或者网络环境不佳导致。

排查与解决步骤
  • 先验证基础网络连通性:直接通过浏览器访问https://registry.npmjs.org,确认是否可以正常打开页面,如果打不开说明当前网络无法连接npm官方源,优先切换国内镜像源解决。
  • 切换npm国内镜像源:执行以下命令将npm默认源替换为国内镜像源,解决官方源访问延迟高的问题:
npm config set registry https://registry.npmmirror.com

执行完成后可通过npm config get registry命令确认配置是否生效,之后重新执行create-react-app的项目创建命令即可。

  • 检查代理配置:如果你当前网络环境需要走代理才能访问外网,先检查npm的代理配置是否正确,执行以下命令查看现有代理配置:
npm config get proxy
npm config get https-proxy

如果返回值为空但你确实需要使用代理,执行以下命令配置代理:

npm config set proxy http://<代理地址>:<代理端口>
npm config set https-proxy http://<代理地址>:<代理端口>

如果返回值有内容但你不需要使用代理,执行以下命令清除错误的代理配置:

npm config delete proxy
npm config delete https-proxy
  • 清理缓存重试:上述操作都完成后如果还是报错,执行以下命令清空npm本地缓存后再重试创建项目:
npm cache clean --force
  • 替代方案:也可以切换其他包管理器创建项目,比如使用pnpm执行pnpm create react-app <项目名称>,或者使用yarn执行yarn create react-app <项目名称>。

内容的提问来源于stack exchange,提问作者Nurlan Mehdiyev

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.26 11:15:02