yarn的bug問題怎么解決

本篇內(nèi)容主要講解“yarn的bug問題怎么解決”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實用性強。下面就讓小編來帶大家學習“yarn的bug問題怎么解決”吧!

1、問題描述

最近接手的幾個項目包管理器用的是 yarn@v1.22.19，在安裝依賴后無論是否成功，總是出現(xiàn)網(wǎng)絡連接問題而且會卡很長時間，然后會出現(xiàn)幾行這樣的異常日志：info There appears to be trouble with your network connection. Retrying...。

有時一些神奇的包(比如 node-sass)出現(xiàn)異常會導致安裝失敗，結果卡了半天才發(fā)現(xiàn)失敗，真的讓人很崩潰。另外在yarn 的 github 倉庫中有數(shù)十條相關的 issue，時間跨度從2016年到2022年足足6年，原因和方案眾說紛紜。我很好奇這到底是個什么神奇的問題居然6年都沒解決，因此決定一探究竟。【相關教程推薦：nodejs視頻教程 、編程視頻】

2、問題排查

2.1、關鍵詞搜索

2.1.1、搜索 github

碰到?jīng)]啥思路的問題和報錯，第一技巧是搜它。在yarn 的 github 倉庫中搜索報錯信息 There appears to be trouble with your network connection，可以看到結果中有1個相關代碼和91個相關 issue。在 issue 里找了一會沒找到合適的方案，接著進入下一步：搜索代碼。

2.1.2、搜索代碼

由于網(wǎng)絡原因這里直接轉(zhuǎn)到本地 yarn 的安裝目錄進行查找。用 vscode 打開 yarn 的安裝目錄（我的本地目錄是~/.volta/tools/image/yarn/1.22.19），全局搜索關鍵詞 There appears to be trouble with your network connection?？梢钥吹浇Y果同樣只有1個，整串錯誤信息賦值給了一個變量offlineRetrying。

全局搜索關鍵詞offlineRetrying 共2處結果，除去上一步的結果只有1處引用。這里的代碼主要是拋出異常和重試，沒有更多關鍵詞可以挖掘。接下來進入調(diào)試環(huán)節(jié)，在 offlineRetrying 這行代碼前面打個斷點，調(diào)試看看具體錯誤信息和上下文。

2.2、程序調(diào)試

2.2.1、確定調(diào)試命令

安裝依賴需要運行命令 yarn， 那要怎么調(diào)試它呢？yarn 是一個 npm 包，執(zhí)行時實際是調(diào)用 node xxx.js，而這個 xxx.js 一般配置在 package.json 的 bin 字段中。從下圖可以看到 yarn 對應的文件是 ./bin/yarn.js，所以可以使用這行調(diào)試命令：node --inspect-brk ~/.volta/tools/image/yarn/1.22.19/bin/yarn.js。（關于 Node.js 的調(diào)試可以參考官方文檔）

2.2.2、開始調(diào)試

先在變量 offlineRetrying 所在的代碼行cli.js:66099之前添加 debugger 語句。

然后回到業(yè)務項目的根目錄中，運行調(diào)試命令 node --inspect-brk ~/.volta/tools/image/yarn/1.22.19/bin/yarn.js。此時程序掛起等待調(diào)試工具連接，并打印出以下日志：

接著打開 chrome 內(nèi)置的調(diào)試頁面 chrome://inspect/#devices，找到文件路徑相同的 Target，點擊 inspect按鈕開始調(diào)試。

接著 chrome 會打開一個獨立的 DevTools 窗口，由于使用的是 node --inspect-brk 命令，此時 DevTools 自動斷點在被調(diào)試文件的起始位置，需要按下 F8 跳過該斷點繼續(xù)執(zhí)行。

等待一小段時間后，DevTools 停在之前添加的斷點處，可以看到這是一個超時異常，導致異常的請求是GET: https://yarnpkg.com/latest-version。使用 curl 請求這個鏈接，結果是 210s 超時。使用代理訪問這個鏈接可以成功，但是請求被重定向到 classic.yarnpkg.com/latest-vers…，其返回結果是 1.22.19。

至此問題基本清楚了，主要是請求超時并且多次重試導致了文章開頭的問題，可以使用代理規(guī)避這個問題。如果排查到此結束就沒意思了。

2.2.3、深入排查

為了進一步了解 yarn 為什么要請求 yarnpkg.com/latest-vers…，以該鏈接為關鍵詞在代碼中搜索，找到了這個關鍵詞鏈條：https://yarnpkg.com/latest-version -> SELF_UPDATE_VERSION_URL ->  _checkUpdate -> checkUpdate，實際調(diào)用關系則正好相反，具體如下圖：

3、確定原因

前面已經(jīng)推斷出超時鏈接的調(diào)用關系是： checkUpdate ->  _checkUpdate  ->  SELF_UPDATE_VERSION_URL -> https://yarnpkg.com/latest-version，再結合 checkUpdate函數(shù)的注釋和代碼來看，每次執(zhí)行 yarn 安裝命令的時候都會請求 yarnpkg.com/latest-vers…，從而檢查是否有新版本需要更新。但是這個鏈接訪問超時而且失敗后會重試，默認的超時時間為 30s 重試次數(shù)為 4 次，所以安裝完成后還會卡 120s 程序才會真正結束。

4、解決方案

引發(fā)問題的關鍵因素有3個：檢查更新、超時、重試，因此可以從優(yōu)化網(wǎng)絡、調(diào)整超時時間、跳過檢查更新3個方向去解決問題，以下有6個解決方案可以參考。

4.1、優(yōu)化網(wǎng)絡

這個思路很容易想到，既然訪問超時，那就提升請求速度。

• 【方案1】使用代理優(yōu)化網(wǎng)絡（推薦）

$ yarn install --proxy "http://{domain}:{port}" --https-proxy "http://{domain}:{port}"

以我的開發(fā)環(huán)境舉例，命令長這樣：

yarn install --proxy "http://10.180.55.191:7890" --https-proxy "http://10.180.55.191:7890"

4.2、調(diào)整超時時間

這個思路比較直接，適用場景更多些，如果其他方法不奏效可以試試。

• 【方案2】修改 network-timeout（看情況）

默認超時時間為 30s 可以改小為 2s，修改后異常依然存在，但是可以讓檢查更新快速失敗不用等幾分鐘。

yarn install --network-timeout 2000

有一部分開發(fā)者表示出現(xiàn)異常是因為某些大型 npm 包安裝太久超過了默認超時時間 30s，因此也可以把network-timeout 改得更大避免異常。

4.3、跳過檢查更新

這個思路的解決方案主要來自 checkUpdate 函數(shù)中的幾個終止條件。

• 【方案3】修改配置禁止檢查更新（推薦）

$ yarn config set disable-self-update-check true$ yarn install

• 【方案4】修改配置把上次更新時間調(diào)到百年后（推薦）

$ yarn config set lastUpdateCheck 1e13
$ yarn install

• 【方案5】執(zhí)行命令時禁用交互式提示（推薦）

$ yarn install --non-interactive

• 【方案6】修改代碼跳過檢查更新（不推薦）

• 找到 yarn 的安裝目錄注釋 checkUpdate 的調(diào)用，具體代碼行為 cli.js:7261，修改后長這樣：// this.checkUpdate();

• 也可以修改其他可以阻斷 checkUpdate 函數(shù)的代碼.

到此，相信大家對“yarn的bug問題怎么解決”有了更深的了解，不妨來實際操作一番吧！這里是億速云網(wǎng)站，更多相關內(nèi)容可以進入相關頻道進行查詢，關注我們，繼續(xù)學習！