无旧Registry访问权限时yarn config set registry执行失败

问题背景 #

在无法可靠访问registry.npmjs.org等公共源的环境中，尝试通过Corepack切换Yarn到本地私有仓库时遇到阻碍：在干净系统执行以下操作（已通过本地源安装Node.js）：

apt-get install nodejs=18.19.0-1nodesource1
corepack enable
yarn config set registry https://privatereg.example.com

关闭网络时，最后一行命令必触发报错，提示Yarn仍在请求registry.npmjs.org：

Internal Error: Error when performing the request to https://registry.npmjs.org/yarn; for troubleshooting help, see https://github.com/nodejs/corepack#troubleshooting
    at ClientRequest.<anonymous> (/usr/lib/node_modules/corepack/dist/lib/corepack.cjs:42195:14)
    at ClientRequest.emit (node:events:517:28)
    at _destroy (node:_http_client:882:13)
    at onSocketNT (node:_http_client:902:5)
    at process.processTicksAndRejections (node:internal/process/task_queues:83:21)

已尝试但无效的操作：

• 使用--npm_config_registry参数，仍会触发联网请求且无法验证配置效果
• 设置YARN_ENABLE_OFFLINE_MODE=1或添加--offline参数，无任何作用
• 断开网络时npm config set registry可正常执行，仅Yarn存在该问题

已知可行但不符合需求的方案：手动修改.yarnrc.yml添加npmRegistryServer: https://privatereg.example.com，但希望通过yarn config命令自动管理配置文件。

可行解决方案 #

1. 临时环境变量配合yarn config设置 #

执行yarn config set前，先通过环境变量临时指定私有源，避免初始请求访问公共源：

YARN_REGISTRY=https://privatereg.example.com yarn config set registry https://privatereg.example.com

该环境变量会临时覆盖Yarn的默认源，确保yarn config命令执行过程中不会触发对registry.npmjs.org的请求。

2. 直接设置Yarn的npmRegistryServer配置项 #

Corepack管理的Yarn（2+版本）实际使用npmRegistryServer作为仓库地址的核心配置项，而非传统的registry，直接设置该参数即可：

yarn config set npmRegistryServer https://privatereg.example.com

此命令不会触发公共源请求，执行后会自动将配置写入.yarnrc.yml，完全符合通过yarn config管理配置的需求。

3. 预创建配置文件再启用Corepack #

若系统完全无网络，可先手动创建基础配置文件，再启用Corepack：

echo "npmRegistryServer: https://privatereg.example.com" > ~/.yarnrc.yml
corepack enable

后续执行yarn config相关命令时，会基于已有配置操作，不会触发公共源请求。

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