GitLab私有项目使用deploy令牌执行npm publish报401错误如何排查

• 检查.npmrc的_authToken字段配置是否正确：你当前的配置写法适用于_auth（Basic认证）场景，而非_authToken。如果你用deploy令牌直接认证，直接把生成的deploy令牌字符串填到_authToken的位置，不需要写<deploy-name>:<deploy-password>格式；如果要使用deploy令牌的用户名+密码组合认证，请将字段改为_auth，值为deploy-name:deploy-password进行Base64编码后的字符串，或者拆分写为：

//gitlab.com/api/v4/projects/28303714/packages/npm/:username=<deploy-name>
//gitlab.com/api/v4/projects/28303714/packages/npm/:_password=<deploy-password的Base64编码值>

• 检查.npmrc中配置的引号是否合规：GitLab npm注册表对单引号兼容性不佳，建议去掉_authToken值外侧的单引号，或者替换为双引号。
• 检查.npmrc的生效优先级：执行npm config list查看当前生效的npm配置，确认项目根目录的.npmrc配置没有被全局/用户目录的.npmrc配置覆盖。
• 检查package.json配置：建议显式添加publishConfig字段指定发布地址，避免跳转错误：

{
  "publishConfig": {
    "@laszlo-bottlik:registry": "https://gitlab.com/api/v4/projects/28303714/packages/npm/"
  }
}

• 检查scope拼写是否一致：确认package.json中name字段的scope@laszlo-bottlik和.npmrc中registry前缀的scope完全一致，无拼写错误。

• 检查deploy令牌配置：确认生成的deploy令牌未过期，且同时勾选了read_package_registry和write_package_registry两个权限，令牌的作用范围是当前laszlo-bottlik/playground项目。
• 检查包注册表功能是否开启：进入项目「设置」-「通用」-「可见性、项目功能、权限」页面，确认「包注册表」功能已开启，且写入权限对当前deploy令牌所属角色开放。
• 检查项目ID是否匹配：确认.npmrc中registry地址里的项目ID28303714确实是当前laszlo-bottlik/playground项目的ID，不要误填为其他项目的ID。
• 检查项目可见性配置：如果项目是私有项目，确认deploy令牌的权限等级足够访问私有资源。

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