TeamCity连接Azure Artifacts npm Registry遇401未授权认证失败

一、检查Azure DevOps PAT（个人访问令牌）的有效性 #

• 权限验证：确保PAT勾选了**Packaging（读取、写入）**权限，不要仅依赖“完全权限”——部分场景下完全权限可能未包含该细分项。同时确认PAT未过期，创建时可选择“无到期日”避免过期问题。
• 认证格式：在TeamCity的NPM连接配置中，用户名可填任意字符串（如npm），密码必须填写完整的PAT。不要错误地使用Azure账号用户名作为认证用户名。

二、确认Registry URL的正确性 #

• 检查URL拼写：确保<组织>、<项目>、<仓库>的名称大小写、拼写与Azure DevOps中的完全一致。
• 尝试两种URL格式：
  • 项目级URL：https://pkgs.dev.azure.com/<组织>/<项目>/_packaging/<仓库>/npm/registry
  • 组织级URL：https://pkgs.dev.azure.com/<组织>/_packaging/<仓库>/npm/registry
    若项目级连接失败，切换为组织级URL重试。

三、TeamCity连接与构建步骤配置检查 #

• 连接类型验证：在TeamCity的NPM Registry Connection中，确保Registry type选择“npm”，避免选错类型导致认证失败。
• 代理环境适配：如果TeamCity服务器处于代理环境，需在TeamCity全局设置中配置代理，确保能正常访问pkgs.dev.azure.com。可在服务器上执行curl -u :<你的PAT> <Registry URL>测试连通性——若curl返回401，问题出在Token/URL而非TeamCity配置。
• 构建步骤配置：
  • 使用TeamCity NPM Task时，在“Advanced”选项中勾选“Use registry from connection”并选择正确的连接，同时避免package.json或本地.npmrc硬编码其他registry导致冲突。
  • 使用Command Line Task执行npm install时，查看构建日志中的.npmrc生成内容，确认包含以下核心配置：

    registry=https://pkgs.dev.azure.com/<组织>/<项目>/_packaging/<仓库>/npm/registry/
    //pkgs.dev.azure.com/<组织>/<项目>/_packaging/<仓库>/npm/registry/:_authToken=<你的PAT>
    

四、Azure Artifacts仓库权限检查 #

登录Azure DevOps，进入目标仓库的“权限”设置页面，确认持有PAT的账号或Token对应的身份，拥有Reader及以上权限。即使PAT有Packaging权限，仓库自身的权限限制也可能导致访问被拒绝。

五、清除缓存 #

• 清除TeamCity服务器缓存：删除system/caches目录下的相关缓存文件，或重启TeamCity服务，避免旧认证信息残留。
• 清除npm缓存：在构建步骤中添加npm cache clean --force命令，清除本地npm缓存。

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