Azure Pipeline的PowerShell任务执行npm install无法访问私有npm包求助

我之前也碰到过一模一样的情况——PowerShell任务不像Azure DevOps自带的npm任务那样自动处理私有源的OAuth认证，哪怕开了作业级的令牌权限，脚本要么拿不到令牌，要么不会自动把令牌传给npm。下面是我亲测有效的解决方案：

第一步：确保PowerShell任务能拿到OAuth令牌 #

作业级的「Allow scripts to access the OAuth token」只是开启了作业的全局权限，但每个PowerShell任务还需要单独启用脚本访问令牌的选项：

• 编辑你的PowerShell任务，切换到Advanced选项卡
• 勾选Allow scripts to access the OAuth token
• 同时确认Agent Job的Additional options里，「Allow scripts to access the OAuth token」也处于启用状态

完成这步后，你的PowerShell脚本就能通过$env:SYSTEM_ACCESSTOKEN环境变量拿到有效的认证令牌了。

第二步：在脚本中配置npm使用令牌访问私有源 #

你有两种方式把令牌传给npm，选一种适合你的场景就行：

方式1：直接用npm config命令配置 #

在执行npm install前，先把令牌绑定到对应的私有源上：

try {
    # 获取OAuth令牌
    $accessToken = $env:SYSTEM_ACCESSTOKEN
    if (-not $accessToken) {
        throw "无法获取OAuth令牌，请检查任务的令牌访问权限是否开启"
    }

    # 替换成你的私有源URL
    $privateRegistry = "https://pkgs.dev.azure.com/YourOrg/_packaging/YourFeed/npm/registry/"
    
    # 配置npm私有源的认证令牌（用户名可以随便填，Azure DevOps只认令牌）
    npm config set "$privateRegistry/:_authToken" "$accessToken"
    # 如果你的包是带scope的（比如@yourscope/package），还要添加scope映射
    npm config set "@yourscope:registry" "$privateRegistry"

    # 带重试逻辑的npm install
    $maxRetries = 3
    $retryCount = 0
    $installSuccess = $false

    while ($retryCount -lt $maxRetries -and -not $installSuccess) {
        try {
            Write-Host "执行npm install（第$($retryCount+1)次尝试）..."
            npm install
            $installSuccess = $true
        }
        catch {
            $retryCount++
            Write-Warning "npm install失败，$($maxRetries - $retryCount)次重试剩余"
            Start-Sleep -Seconds 5
        }
    }

    if (-not $installSuccess) {
        throw "经过$maxRetries次重试后，npm install仍然失败"
    }
}
catch {
    Write-Error $_.Exception.Message
    exit 1
}

方式2：生成临时.npmrc文件 #

如果你的私有源配置比较复杂，或者不想修改全局npm配置，可以临时生成项目级的.npmrc文件：

$accessToken = $env:SYSTEM_ACCESSTOKEN
if (-not $accessToken) {
    throw "无法获取OAuth令牌，请检查任务权限"
}

# 构造.npmrc内容，替换成你的私有源和scope
$npmrcContent = @"
registry=https://registry.npmjs.org/
@yourscope:registry=https://pkgs.dev.azure.com/YourOrg/_packaging/YourFeed/npm/registry/
//pkgs.dev.azure.com/YourOrg/_packaging/YourFeed/npm/registry/:_authToken=$accessToken
//pkgs.dev.azure.com/YourOrg/_packaging/YourFeed/npm/:_authToken=$accessToken
"@

# 写入项目目录的.npmrc
$npmrcPath = Join-Path $env:BUILD_SOURCESDIRECTORY ".npmrc"
Set-Content -Path $npmrcPath -Value $npmrcContent -Force

# 执行带重试的npm install
$maxRetries = 3
$retryCount = 0
$installSuccess = $false

while ($retryCount -lt $maxRetries -and -not $installSuccess) {
    try {
        Write-Host "执行npm install（第$($retryCount+1)次尝试）..."
        npm install
        $installSuccess = $true
    }
    catch {
        $retryCount++
        Write-Warning "npm install失败，$($maxRetries - $retryCount)次重试剩余"
        Start-Sleep -Seconds 5
    }
}

# 可选：清理临时.npmrc，避免影响后续任务
Remove-Item -Path $npmrcPath -Force -ErrorAction SilentlyContinue

if (-not $installSuccess) {
    throw "经过$maxRetries次重试后，npm install仍然失败"
}

第三步：验证构建服务账号的Feed权限 #

如果配置完还是报E401，大概率是构建服务账号没有私有Feed的访问权限：

1. 进入Azure DevOps的Artifacts -> 你的目标Feed
2. 点击右上角的设置图标 -> Permissions
3. 添加Project Collection Build Service (你的组织名)账号，赋予Reader权限
4. 保存设置后重新运行构建

这样应该就能彻底解决E401的问题，让PowerShell任务里的npm install顺利执行了。

内容的提问来源于stack exchange，提问作者Lukasz 'Severiaan' Grela