如何解决安装私有GitHub包时出现的401 Unauthorized报错

本地环境变量读取问题（你已解决，可参考） #

你遇到的末尾斜杠问题是npm配置GitHub Packages的常见坑，项目级.npmrc中配置auth地址时不能携带末尾斜杠，你调整后的配置是正确的。本地使用时只需确保NPM_TOKEN已注入当前终端会话，比如Mac/Linux下执行export NPM_TOKEN=你的令牌值后再执行安装命令即可正常读取。

Netlify部署401问题解决方案 #

按以下步骤逐一排查即可：

• 确认Netlify环境变量配置正确：进入对应站点的「站点设置-环境变量」页面，添加名为NPM_TOKEN的变量，不要给令牌值加任何单引号、双引号包裹，同时确保变量生效范围包含「所有部署上下文」，不要仅限定为本地开发环境。
• 确认.npmrc中的OWNER占位符已替换为实际的GitHub用户名/组织名，大小写和GitHub上保持完全一致。
• 确认你的GitHub个人访问令牌权限足够：必须勾选read:packages权限，如果私有包归属于组织，还需要在组织的第三方访问设置中放行该令牌的访问权限。
• 低版本npm不支持项目级.npmrc读取环境变量，建议在package.json中指定npm版本，示例如下：

{
  "name": "你的项目名",
  "engines": {
    "npm": ">=8.0.0"
  }
}

• 所有配置修改后，在Netlify部署页面点击「清除缓存并部署」，避免旧的构建缓存导致配置不生效。
• 若仍报错可临时修改Netlify构建命令排查变量注入情况：将默认构建命令改为echo ${NPM_TOKEN:0:5} && npm run build，仅打印令牌前5位避免泄露，若输出为空说明环境变量未正确配置，重新检查Netlify的变量设置即可。

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