使用Yarn从私有Azure DevOps Registry安装包遇问题

问题背景 #

配置.yarnrc.yml尝试从Azure DevOps私有注册表安装@mycompany/mypackage，配置内容如下：

npmScopes:
  mycompany:
    npmRegistryServer: https://pkgs.dev.azure.com/mycompany/_packaging/myproject/npm/registry/
    npmAlwaysAuth: true
    npmAuthToken: <my-auth-token>

执行yarn add @mycompany/mypackage时触发错误：

➤ YN0027: @mycompany/mypackage@unknown can't be resolved to a satisfying range
➤ YN0041: Invalid authentication (as an unknown user)
➤ Errors happened when preparing the environment required to run this command.

但使用对应.npmrc配置通过npm安装完全正常，版本环境为Yarn 3.6.4、npm 10.8.1、Node.js 18.20.3，且已验证包存在、PAT令牌权限有效。

可行解决方案 #

1. 补充Azure DevOps所需的多路径认证配置 #

Azure DevOps私有注册表需要同时对registry/根路径和npm/上游路径做认证，仅配置npmScopes可能覆盖不全，调整.yarnrc.yml如下：

npmScopes:
  mycompany:
    npmRegistryServer: https://pkgs.dev.azure.com/mycompany/_packaging/myproject/npm/registry/
    npmAlwaysAuth: true
    npmAuthToken: "<你的PAT令牌>"

# 新增全局注册表认证规则，覆盖Azure DevOps的两个关键路径
npmRegistries:
  "https://pkgs.dev.azure.com/mycompany/_packaging/myproject/npm/registry/":
    npmAlwaysAuth: true
    npmAuthToken: "<你的PAT令牌>"
  "https://pkgs.dev.azure.com/mycompany/_packaging/myproject/npm/":
    npmAlwaysAuth: true
    npmAuthToken: "<你的PAT令牌>"

注意：此处直接使用明文PAT令牌即可，无需像npm那样做base64编码。

2. 直接导入现有npm配置 #

既然npm配置已经验证可用，可通过Yarn内置命令一键导入.npmrc的配置规则，自动转换为Yarn兼容格式：

yarn config import

执行后重新尝试安装命令即可。

3. 排查PAT令牌的有效性 #

• 确认PAT拥有**Packaging (Read)**权限，且未过期
• 避免令牌中特殊字符导致的转义问题，建议直接复制原始令牌内容，不要手动修改

验证方法 #

执行以下命令确认配置是否生效：

yarn config list
# 或者直接查询包信息验证连通性
yarn info @mycompany/mypackage

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