Bootstrap

【Yarn Bug】 yarn 安装依赖出现的网络连接问题

最近,在初始化 Ant Design Pro 前端脚手架过程中,使用 yarn 安装依赖时遇到了网络连接问题,具体错误信息提示为 info There appears to be trouble with your network connection. Retrying...。通过百度查询,得知出现这种问题的原因可能是:

(1)网络连接问题:设备无法正常访问互联网

(2)代理或 VPN 问题:设备当前使用了代理或 VPN

(3)Yarn 版本问题:旧版本 Yarn 可能不支持某些网络配置

(4)防护墙问题:防火墙或安全软件阻止了 Yarn 的网络请求

(5)网络延迟:Yarn 访问依赖仓库过程缓慢

我稍微检查了上面的问题(1)-(4),排除了这几种情况,认为是网络延迟造成的。之后我开始思考是不是没有将 Yarn 的下载源从官网仓库改成国内镜像服务。于是我用一种比较直接的方式检查了 Yarn 的镜像配置信息,即打开C盘下的用户目录,找到 ~/.yarnrc 配置文件,并查看其中的内容:

# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
# yarn lockfile v1


registry "https://registry.npm.taobao.org"
electron_mirror "https://npm.taobao.org/mirrors/electron/"
lastUpdateCheck 1732329676400

看见 registry 已经配置成了淘宝镜像。这时候我继续百度了一下发现:早在 2021 年,淘宝就已经将 npm 淘宝镜像从 registry.npm.taobao.org 切换到了 registry.npmmirror.com。于是我修改了这个配置文件,将镜像改成了这个新地址:

# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
# yarn lockfile v1


registry "https://registry.npmmirror.com"
electron_mirror "https://npm.taobao.org/mirrors/electron/"
lastUpdateCheck 1732936052925

在完成配置后,重新使用 yarn 命令安装依赖,问题得以解决。不过,导致上述问题的原因可能不止于此,且这种解决方式也可能并不适用于所有情况,仅供参考。

;