GitLab CICD部署时安装npm私有包出现404错误该如何解决？

问题修复方案 #

• 首先排查CI日志中npm whoami的执行结果
  如果该命令返回报错而非正常的npm用户名，说明身份验证未生效，需优先检查：
  • 你生成的npm访问令牌是否开启了read:packages权限，且已获得对应私有组织的访问授权
  • CI环境变量中存储的<MY_AUTH_TOKEN>值是否正确，无多余空格、换行或转义异常
• 补充scope组织的registry配置
  你的私有包属于@<MY_ORG>组织范围，需在.npmrc中明确指定该组织对应的registry地址，修改构建脚本如下（注意使用>>追加配置，避免覆盖已有内容）：

  whoami
  echo $PATH
  source /etc/environment
  # 配置scope组织对应的registry
  echo '@<MY_ORG>:registry=https://registry.npmjs.org/' >> .npmrc
  # 配置registry的访问令牌
  echo '//registry.npmjs.org/:_authToken=<MY_AUTH_TOKEN>' >> .npmrc
  # 可选：打印.npmrc内容，排查配置是否正确
  cat .npmrc
  npm whoami
  npm i
  

• 确认私有包版本有效性
  登录npm官方后台检查@<MY_ORG>/<PRIVATE_PACKAGE_NAME>是否确实发布了1.0.1版本，避免本地存在未发布的缓存版本导致线上拉取失败
• 确认配置文件路径
  确认脚本执行目录与npm install的执行目录均为项目根目录，保证生成的.npmrc文件可以被npm正常读取
• 可选排查：升级npm版本
  部分旧版本npm对scope包的配置读取存在兼容问题，可在脚本中添加命令升级npm到最新稳定版：

  npm install -g npm@latest
  

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