最近遇到一个yarn的bug，搜索之后发现它竟然存在6年之久，这到底是个怎样神奇的问题？经过一番分析排查，我给了6个解决方案。。。
1、问题描述
最近接手的几个项目包管理器用的是 yarn@v1.22.19，在安装依赖后无论是否成功，总是出现网络连接问题而且会卡很长时间，然后会出现几行这样的异常日志：info There appears to be trouble with your network connection. Retrying...。
有时一些神奇的包(比如 node-sass)出现异常会导致安装失败，结果卡了半天才发现失败，真的让人很崩溃。另外在yarn 的 github 仓库中有数十条相关的 issue，时间跨度从2016年到2022年足足6年，原因和方案众说纷纭。我很好奇这到底是个什么神奇的问题居然6年都没解决，因此决定一探究竟。【相关教程推荐：nodejs视频教程 、编程视频】
2、问题排查
2.1、关键词搜索
2.1.1、搜索 github
碰到没啥思路的问题和报错，第一技巧是搜它。在yarn 的 github 仓库中搜索报错信息 There appears to be trouble with your network connection，可以看到结果中有1个相关代码和91个相关 issue。在 issue 里找了一会没找到合适的方案，接着进入下一步：搜索代码。
2.1.2、搜索代码
由于网络原因这里直接转到本地 yarn 的安装目录进行查找。用 vscode 打开 yarn 的安装目录（我的本地目录是~/.volta/tools/image/yarn/1.22.19），全局搜索关键词 There appears to be trouble with your network connection。可以看到结果同样只有1个，整串错误信息赋值给了一个变量offlineRetrying。
全局搜索关键词offlineRetrying 共2处结果，除去上一步的结果只有1处引用。这里的代码主要是抛出异常和重试，没有更多关键词可以挖掘。接下来进入调试环节，在 offlineRetrying 这行代码前面打个断点，调试看看具体错误信息和上下文。
2.2、程序调试
2.2.1、确定调试命令
安装依赖需要运行命令 yarn， 那要怎么调试它呢？yarn 是一个 npm 包，执行时实际是调用 node xxx.js，而这个 xxx.js 一般配置在 package.json 的 bin 字段中。从下图可以看到 yarn 对应的文件是 ./bin/yarn.js，所以可以使用这行调试命令：node --inspect-brk ~/.volta/tools/image/yarn/1.22.19/bin/yarn.js。（关于 Node.js 的调试可以参考官方文档）
2.2.2、开始调试
先在变量 offlineRetrying 所在的代码行cli.js:66099之前添加 debugger 语句。
然后回到业务项目的根目录中，运行调试命令 node --inspect-brk ~/.volta/tools/image/yarn/1.22.19/bin/yarn.js。此时程序挂起等待调试工具连接，并打印出以下日志：
接着打开 chrome 内置的调试页面 chrome://inspect/#devices，找到文件路径相同的 Target，点击 inspect按钮开始调试。
接着 chrome 会打开一个独立的 DevTools 窗口，由于使用的是 node --inspect-brk 命令，此时 DevTools 自动断点在被调试文件的起始位置，需要按下 F8 跳过该断点继续执行。
等待一小段时间后，DevTools 停在之前添加的断点处，可以看到这是一个超时异常，导致异常的请求是GET: https://yarnpkg.com/latest-version。使用 curl 请求这个链接，结果是 210s 超时。使用代理访问这个链接可以成功，但是请求被重定向到 classic.yarnpkg.com/latest-vers…，其返回结果是 1.22.19。
至此问题基本清楚了，主要是请求超时并且多次重试导致了文章开头的问题，可以使用代理规避这个问题。如果排查到此结束就没意思了。
2.2.3、深入排查
为了进一步了解 yarn 为什么要请求 yarnpkg.com/latest-vers…，以该链接为关键词在代码中搜索，找到了这个关键词链条：https://yarnpkg.com/latest-version -> SELF_UPDATE_VERSION_URL -> _checkUpdate -> checkUpdate，实际调用关系则正好相反，具体如下图：
3、确定原因
前面已经推断出超时链接的调用关系是： checkUpdate -> _checkUpdate -> SELF_UPDATE_VERSION_URL -> https://yarnpkg.com/latest-version，再结合 checkUpdate函数的注释和代码来看，每次执行 yarn 安装命令的时候都会请求 yarnpkg.com/latest-vers…，从而检查是否有新版本需要更新。但是这个链接访问超时而且失败后会重试，默认的超时时间为 30s 重试次数为 4 次，所以安装完成后还会卡 120s 程序才会真正结束。
4、解决方案
引发问题的关键因素有3个：检查更新、超时、重试，因此可以从优化网络、调整超时时间、跳过检查更新3个方向去解决问题，以下有6个解决方案可以参考。
4.1、优化网络
这个思路很容易想到，既然访问超时，那就提升请求速度。
- 【方案1】使用代理优化网络（推荐）
$ yarn install --proxy "http://{domain}:{port}" --https-proxy "http://{domain}:{port}"以我的开发环境举例，命令长这样：
yarn install --proxy "http://10.180.55.191:7890" --https-proxy "http://10.180.55.191:7890"
4.2、调整超时时间
这个思路比较直接，适用场景更多些，如果其他方法不奏效可以试试。
- 【方案2】修改 network-timeout（看情况）
默认超时时间为 30s 可以改小为 2s，修改后异常依然存在，但是可以让检查更新快速失败不用等几分钟。
yarn install --network-timeout 2000
有一部分开发者表示出现异常是因为某些大型 npm 包安装太久超过了默认超时时间 30s，因此也可以把network-timeout 改得更大避免异常。
4.3、跳过检查更新
这个思路的解决方案主要来自 checkUpdate 函数中的几个终止条件。
- 【方案3】修改配置禁止检查更新（推荐）
$ yarn config set disable-self-update-check true$ yarn install
- 【方案4】修改配置把上次更新时间调到百年后（推荐）
$ yarn config set lastUpdateCheck 1e13 $ yarn install
- 【方案5】执行命令时禁用交互式提示（推荐）
$ yarn install --non-interactive
- 【方案6】修改代码跳过检查更新（不推荐）
- 找到
yarn的安装目录注释checkUpdate的调用，具体代码行为cli.js:7261，修改后长这样：// this.checkUpdate(); - 也可以修改其他可以阻断
checkUpdate函数的代码...
- 找到
5、最后
以上主要是分享一些问题分析排查的经验，另外也提供了一些 yarn install 超时异常的解决方案，希望能对前端同学们有所帮助。
在快写完这篇文章的时候，yarnpkg.com/latest-vers… 已经可以正常访问，不知道还会不会有人再遇到这个问题。
另外我在
yarn的github issue中回复了以上的解决方案，希望前端同学们少受点折磨，也希望官方早点修复这个6年陈的老Bug。?
更多编程相关知识，请访问：编程教学！！
