Yarn 2(Berry)无法读取家目录.yarnrc.yml中的npmAuthToken导致安装认证失败问题求助

你在从Yarn 1迁移到Yarn 3时遇到的私有Registry认证失败问题，主要是因为Yarn 3的配置加载、合并逻辑和Yarn 1存在不少差异，我整理了几个排查和解决的思路：

1. 确认配置的合并与加载逻辑 #

Yarn 3会同时加载**家目录（_{/.yarnrc.yml）**和**项目目录（}/Project/MyProject/.yarnrc.yml）**的配置，但需要注意：

• 两个配置文件中的npmScopes.company配置会合并，项目配置里没有的键会继承家目录的设置（你的项目配置没写npmAuthToken，理论上家目录的应该会被合并进来）
• 检查company这个scope名称是否完全一致（大小写敏感！比如家目录写Company而项目是company就会匹配失败）

2. 验证当前生效的配置 #

执行以下命令查看Yarn加载的所有配置，重点确认npmScopes.company下是否包含npmAuthToken：

yarn config list --verbose

如果输出里看不到npmAuthToken，说明家目录的配置没有被正确加载，可能是文件路径错误或者YAML语法问题（比如~/.yarnrc.yml的缩进是否符合规范）。

3. 修复配置加载问题的几种方案 #

方案A：用Yarn命令统一设置全局认证信息 #

避免手动编辑YAML文件可能出现的语法错误，直接用Yarn命令在家目录配置中添加token：

yarn config set npmScopes.company.npmAuthToken "NpmToken.token" --home

这个命令会自动将配置写入~/.yarnrc.yml，确保格式完全符合Yarn 3的要求。

方案B：使用环境变量临时/永久设置token #

Yarn 3支持用环境变量传递认证信息，优先级高于配置文件：

• 临时使用：在执行install时直接传入环境变量

  COMPANY_NPM_AUTH_TOKEN=NpmToken.token yarn install
  

  环境变量命名规则是：[SCOPE]_NPM_AUTH_TOKEN，其中scope名称要大写，特殊字符（比如.）换成_
• 永久设置：把环境变量添加到你的shell配置文件（比如~/.bashrc或~/.zshrc）中：

  export COMPANY_NPM_AUTH_TOKEN=NpmToken.token
  

方案C：检查项目配置的细节 #

确保项目的~/.yarnrc.yml中的registry配置正确：

• 确认npmRegistryServer和npmPublishRegistry的URL没有拼写错误，比如是否遗漏了https://，或者末尾斜杠的问题
• npmAlwaysAuth: true是正确配置，私有Registry需要每次请求都携带认证信息

4. 清除缓存并重新尝试 #

有时候旧的缓存会导致认证信息不生效，执行以下命令清除缓存后重新install：

yarn cache clean
yarn install

额外提示 #

Yarn 3和Yarn 1的配置体系差异较大，如果你之前依赖~/.npmrc的配置，Yarn 3默认不会自动读取.npmrc，所以必须把认证信息迁移到.yarnrc.yml中，或者通过环境变量传递。

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