Azure DevOps管道中npm认证失败问题求助

问题情况 #

使用以下YAML配置部署Angular应用到Azure DevOps管道时，npm install步骤抛出E401认证错误：

# Node.js with Angular

# Build a Node.js project that uses Angular.
trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
- task: NodeTool@0
  inputs:
    versionSpec: '18.x'
  displayName: 'Install Node.js'

- task: npmAuthenticate@0
  inputs:
    workingFile: '.npmrc'
- script: |
    npm install -g @angular/cli
    npm install
    ng build --prod
  displayName: 'npm install and build'

报错信息：

npm ERR! code E401 
npm ERR! Unable to authenticate, your authentication token seems to be invalid.

本地环境可正常运行，依赖外部组织的npm源，本地通过用户目录下的.npmrc存储凭证，项目目录下的.npmrc配置仓库地址。已尝试将含仓库地址的.npmrc放在仓库根目录、将用户.npmrc内容存入变量并在YAML中写入文件，均未解决问题。

解决方案 #

1. 规范项目根目录.npmrc配置 #

项目根目录的.npmrc仅保留外部npm源的仓库地址配置，不要包含任何凭证信息，示例：

@your-external-org:registry=https://your-external-npm-registry.com/

将这个文件提交到代码仓库。

2. 在Azure DevOps中配置秘密变量 #

1. 打开你的ADO管道，进入「变量」设置
2. 添加一个秘密变量（比如命名为ExternalNpmToken），值为你本地用户目录.npmrc中对应外部源的认证token（即//your-external-npm-registry.com/:_authToken=后面的内容）
3. 确保变量勾选「保持秘密」选项

3. 修改YAML管道，注入凭证 #

移除原有的npmAuthenticate@0任务（该任务主要针对Azure Artifacts私有源，不适用于外部第三方npm源），添加脚本任务将凭证注入到.npmrc中，修改后的完整YAML：

# Node.js with Angular

trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
- task: NodeTool@0
  inputs:
    versionSpec: '18.x'
  displayName: 'Install Node.js'

# 注入外部npm源的认证凭证到项目根目录.npmrc
- script: |
    echo "//your-external-npm-registry.com/:_authToken=$(ExternalNpmToken)" >> .npmrc
  displayName: 'Inject external npm registry authentication token'

- script: |
    npm install -g @angular/cli
    npm install
    ng build --prod
  displayName: 'npm install and build'

4. 额外排查点 #

• 如果外部npm源使用的是用户名+密码认证，需要将用户名:密码进行Base64编码，然后将编码后的值作为_auth存入变量，脚本改为：

  echo "//your-external-npm-registry.com/:_auth=$(ExternalNpmAuth)" >> .npmrc
  

• 执行管道时，可以在npm install前添加npm config list脚本，查看当前npm配置是否正确加载了凭证和仓库地址
• 确保ADO代理池的虚拟机有访问外部npm源的网络权限（比如没有被防火墙拦截）

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