Jenkins代理环境下.npmrc的registry配置未被npm install识别

刚好碰到过类似的代理环境下用Nexus搭建私有npm仓、在Jenkins里跑构建的问题，给你梳理下解决步骤：

1. 先修正你的npm registry配置命令 #

你之前执行的npm config get命令明显写错了——get是用来读取当前registry配置的，后面不能跟仓库地址。如果要设置Nexus作为registry，得用set命令：

/var/jenkins_home/tools/jenkins.plugins.nodejs.tools.NodeJSInstallation/nodejs-default/bin/npm config set registry https://nexus/repository/npm-all/

设置完之后，再用不带地址的get命令验证是否配置成功：

/var/jenkins_home/tools/jenkins.plugins.nodejs.tools.NodeJSInstallation/nodejs-default/bin/npm config get registry

2. 理清Jenkins中.npmrc的配置优先级 #

Jenkins里的.npmrc配置可能会被多种因素覆盖，要注意这几点：

• 检查Jenkins的全局工具配置里，NodeJS安装是否关联了正确的自定义.npmrc；或者干脆在Jenkinsfile/构建shell步骤里显式设置registry，避免优先级冲突
• 如果你的项目根目录有本地.npmrc，一定要确认里面的registry也是指向你的Nexus仓库，不然会覆盖全局配置
• 代理环境下别忘配置npm的代理参数（如果Nexus需要通过代理拉取公网npm包）：

  npm config set proxy http://你的代理地址:端口
  npm config set https-proxy http://你的代理地址:端口
  # 代理需要认证的话加上这两行
  npm config set proxy-auth 用户名:密码
  npm config set https-proxy-auth 用户名:密码
  

3. 排查npm install的具体错误原因 #

你没贴完整的报错信息，建议先执行带详细日志的安装命令，定位问题：

npm install --verbose

常见的报错原因包括：

• Nexus仓库配置错误：比如npm-all仓库没开启公网代理、私有包没上传到Nexus
• 网络权限问题：Jenkins运行的jenkins用户有没有权限访问Nexus，防火墙/安全组有没有拦截请求
• 依赖包不存在：确认你要安装的包在Nexus仓库里能找到（不管是代理的公包还是私有包）

4. 简化Jenkins中的npm调用 #

其实在Jenkins里如果已经配置了NodeJS工具，完全不用写这么长的路径，直接用npm命令就行，比如在构建shell里：

npm config set registry https://nexus/repository/npm-all/
npm install --verbose

这样既简洁，也能避免路径写错的问题。

内容的提问来源于stack exchange，提问作者Dániel Kis