使用Nexus私有npm仓库执行npm install时出现403错误

遇到这种在企业代理后访问Nexus私有npm仓库报403的情况，大概率是代理配置冲突、权限设置不到位或者认证信息有问题，我给你梳理几个关键排查点，一步步来解决：

• 检查代理排除配置，避免私有仓库走企业代理
  很多时候全局代理配置会把内部Nexus的请求也发往企业代理，而代理服务器可能拦截了内部地址的请求导致403。你可以先执行npm config list查看当前的代理设置，确认是否有proxy和https-proxy字段。如果有的话，一定要把Nexus的域名或IP加入到no-proxy列表里：

  npm config set no-proxy "your-nexus-domain.com,192.168.xxx.xxx"
  

  要是你用的是项目目录下的.npmrc文件，直接在里面添加no-proxy=your-nexus-domain.com,192.168.xxx.xxx即可，多个地址用逗号分隔。

• 验证Nexus私有仓库的权限与Realm配置
  就算你开了匿名访问，也得确认Nexus给匿名用户分配了正确的权限：

  1. 登录Nexus后台，找到你的私有npm仓库，进入「Permissions」标签页，检查匿名角色是否拥有nx-repository-view-npm-*-read这类读取权限；
  2. 再去「Security」→「Realms」页面，确保npm Bearer Token Realm已经启用——这个是npm认证的核心，没开的话哪怕你执行了npm login，认证请求也会失败。
     如果是需要认证的仓库，还要检查你的账号角色是否有对应的读写权限。

• 确认npm认证信息是否正确写入配置
  执行npm login或npm adduser后，有时候认证信息没有正确写入.npmrc，或者你指定的registry地址不对。你可以打开用户目录下的.npmrc（Linux/Mac是~/.npmrc，Windows是C:\Users\你的用户名\.npmrc），看看有没有类似下面的配置：

  //your-nexus-domain.com/repository/npm-private/:_authToken=xxxxxx
  

  或者是用base64编码的_auth字段。如果没有的话，重新执行带registry参数的登录命令：

  npm login --registry=https://your-nexus-domain.com/repository/npm-private/
  

  输入用户名密码后再检查.npmrc是否更新。

• 查看Nexus日志定位具体拒绝原因
  要是上面几步都没解决，直接看Nexus的请求日志最靠谱。日志一般在Nexus安装目录的sonatype-work/nexus3/log/request.log里，找到对应的403请求记录，里面会明确说明是权限不足、认证失败还是其他原因，比如"reason":"Insufficient permissions for repository"，这样就能精准定位问题了。

• 测试直接访问Nexus仓库
  在构建服务器上用curl直接请求私有仓库地址：

  curl -v https://your-nexus-domain.com/repository/npm-private/
  

  如果返回403，那基本是Nexus的权限配置问题；如果连不上，可能是网络或者代理的排除配置没生效。

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