无法执行npm publish到内部Nexus npm私有仓库，如何排查解决？

问题根因 #

你的发布失败是由3处配置错误导致npm无法匹配到正确的认证信息，触发401鉴权失败：

1. 项目级.npmrc配置格式错误：你将_auth参数直接拼接在了registry地址后，registry字段仅支持填写纯仓库地址，附带参数会导致npm识别仓库地址错误，执行npm adduser时请求的地址也是拼接了错误参数的无效地址。
2. 全局.npmrc的认证路径不匹配：你配置的token作用路径是//internal_nexus_url:8081/repository/，而实际发布的目标仓库是子路径npm-private，npm的认证规则是路径精确匹配，短路径不会自动继承到子路径，因此发布时找不到对应仓库的认证信息。
3. 两种认证方式混用冲突：你同时配置了token认证（全局）和基础auth认证（项目级），npm会优先读取项目级配置，格式错误的项目级配置导致认证完全失效。

解决步骤 #

1. 修正项目级.npmrc配置 #

删除原错误配置，替换为如下格式，注意registry不要加引号、不要拼接任何参数：

registry=http://internal_nexus_url:8081/repository/npm-private/
_auth=base64_user_pw
always-auth=true
# 如果是http协议的nexus，添加下面这行避免高版本npm的ssl校验报错
strict-ssl=false

注意：确保你的base64_user_pw是你的Nexus用户名:密码字符串的标准base64编码，没有多余换行或空白字符

2. 调整全局.npmrc配置 #

删除原有的不匹配的token配置，如果需要全局保留该仓库的认证，按如下格式填写：

//internal_nexus_url:8081/repository/npm-private/:_authToken=NpmToken.43b77b61-2492-39b8-8150-38555f6b6943
//internal_nexus_url:8081/repository/npm-private/:always-auth=true

如果项目级已经配置了_auth认证，可以直接清空全局.npmrc的对应配置，避免优先级冲突。

3. 重新执行登录/发布操作 #

指定正确的registry地址执行adduser：

npm adduser --registry=http://internal_nexus_url:8081/repository/npm-private/

输入你的Nexus用户名、密码、公开邮箱，提示登录成功后再执行npm publish即可。

额外检查项 #

• 登录Nexus后台确认你的账号对npm-private仓库拥有添加、编辑权限，对应角色权限为nx-repository-view-npm-*-add、nx-repository-view-npm-*-edit
• 确认Nexus的npm仓库配置中已开启「允许重新发布」选项，避免覆盖版本时触发权限报错

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