Mac环境下安装ADO Artifacts私有NPM包出现401未授权错误

问题场景 #

我在ADO上发布了私有包@foo/bar，严格按照官方文档完成以下配置后，执行npm install @foo/bar仍收到401未授权错误：

1. 用户级.npmrc配置（已替换占位符为实际信息）：

; begin auth token
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/:username=[username]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/:email=[email]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/:username=[username]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/:email=[email]
; end auth token

2. 项目级.npmrc配置：

@foo:registry=https://pkgs.dev.azure.com...
always-auth=true

3. 克隆项目baz后执行安装命令，无法拉取包，返回401。

已尝试操作：

• 为用户级.npmrc添加作用域
• 给PAT令牌添加引号包裹
• 重新生成PAT
• 执行npm login --source @foo，但因权限策略CLI无限加载
• 调整作用域与注册表映射关系

排查步骤与解决方案 #

1. 验证PAT权限与编码正确性 #

• 确认PAT权限：必须勾选Packaging下的Read权限，同时确保令牌未过期、组织/项目匹配。
• 检查Base64编码：直接使用PAT原文进行编码（禁止添加空格、换行等额外字符），可通过以下命令验证：

  # Mac/Linux
  echo -n "your-pat-token" | base64
  # Windows PowerShell
  [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("your-pat-token"))
  

  确保用户级.npmrc中的_password值与上述结果完全一致。

2. 统一注册表路径 #

项目级.npmrc的注册表地址必须和用户级授权配置的地址完全匹配（包括末尾的/），正确配置示例：

@foo:registry=https://pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/
always-auth=true

注意：若feed为组织级而非项目级，路径应为https://pkgs.dev.azure.com/[org name]/_packaging/[artifact feed name]/npm/registry/，需确认feed实际层级。

3. 绑定用户级.npmrc作用域（可选） #

在用户级.npmrc中直接绑定作用域到注册表，避免项目级配置遗漏：

@foo:registry=https://pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/
; begin auth token
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/:username=[username]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/registry/:email=[email]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/:username=[username]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/[org name]/[project id]/_packaging/[artifact feed name]/npm/:email=[email]
; end auth token

4. 清理缓存与验证配置 #

• 清理npm缓存：

  npm cache clean --force
  

• 验证配置加载情况：

  npm config list
  

  确认@foo:registry和对应授权配置已正确加载。

5. 检查环境变量冲突 #

若系统存在NPM_CONFIG_REGISTRY等npm相关环境变量，可能覆盖本地配置，执行以下命令排查：

# Mac/Linux
echo $NPM_CONFIG_REGISTRY
# Windows PowerShell
echo $env:NPM_CONFIG_REGISTRY

若存在无关变量，临时取消后重新尝试安装。

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