Jenkins执行corepack prepare yarn@3.4.1 --activate遇HTTP 503错误求助

问题背景 #

在Jenkins中执行以下操作时遇到错误：

1. 通过.nvmrc设置Node版本为v16.15.1，执行脚本：

   if (fileExists('.nvmrc')) {
     sh 'bash -l -c "(((nvm install > /dev/null) && nvm use) && nvm alias default node) || true"'
   }
   

2. 安装并启用corepack后，执行corepack prepare yarn@3.4.1 --activate（package.json指定packageManager: yarn@3.4.1），报错：

   16:14:42  Internal Error: Server answered with HTTP 503
   16:14:42      at ClientRequest.<anonymous> (/usr/local/nvm/versions/node/v16.15.1/lib/node_modules/corepack/dist/corepack.js:3933:31)
   16:14:42      at Object.onceWrapper (node:events:642:26)
   16:14:42      at ClientRequest.emit (node:events:527:28)
   16:14:42      at HTTPParser.parserOnIncomingClient [as onIncoming] (node:_http_client:631:27)
   16:14:42      at HTTPParser.parserOnHeadersComplete (node:_http_common:128:17)
   16:14:42      at TLSSocket.socketOnData (node:_http_client:494:22)
   16:14:42      at TLSSocket.emit (node:events:527:28)
   16:14:42      at addChunk (node:internal/streams/readable:315:12)
   16:14:42      at readableAddChunk (node:internal/streams/readable:289:9)
   16:14:42      at TLSSocket.Readable.push (node:internal/streams/readable:228:10)
   

解决方案 #

HTTP 503错误表明corepack请求的yarn包源服务暂时不可用，可通过以下方式解决：

1. 切换国内镜像源 #

在执行corepack prepare前设置yarn镜像环境变量，替换为国内稳定源：

sh 'export YARN_REGISTRY=https://registry.npmmirror.com && corepack prepare yarn@3.4.1 --activate'

2. 验证网络连通性 #

在Jenkins脚本中添加网络测试命令，确认节点能正常访问包源：

sh 'curl -I https://registry.yarnpkg.com/yarn-v3.4.1.tgz'

如果返回503，需联系运维调整Jenkins节点的网络策略，或更换镜像源。

3. 本地离线安装 #

手动下载yarn包到Jenkins节点本地，再指定本地路径执行prepare：

sh 'wget https://registry.npmmirror.com/yarn/-/yarn-3.4.1.tgz -O /tmp/yarn-3.4.1.tgz'
sh 'corepack prepare file:///tmp/yarn-3.4.1.tgz --activate'

4. 更新corepack到最新版本 #

旧版corepack可能存在源请求的bug，先更新再执行命令：

sh 'npm install -g corepack@latest && corepack prepare yarn@3.4.1 --activate'

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