发布npm包新版本时报npm ERR!404 包不在注册表如何解决

这个报错是npm发布场景的典型误导性报错，提示里的“包不存在”不是真实原因，核心触发原因共三类：

• 发布的是@开头的作用域包时，npm默认将这类包识别为私有包，如果你用的是免费npm账号、没开通私有包托管服务，直接执行npm publish就会触发该报错，和包之前是否公开发布过没有关系。
• 当前登录的npm账号没有目标包的发布权限：这个包之前由其他人员发布，如果你没被添加为包的协作者或维护者，npm出于安全考虑不会返回403权限错误，而是直接返回404伪装成包不存在，避免攻击者枚举内部包信息。
• 包名配置错误：package.json里的name字段和npm上已发布的历史包名不匹配，比如作用域包漏写斜杠后的包名、拼写错误，npm找不到对应发布目标就会返回404。

按顺序操作即可：

1. 核对包名：打开项目根目录的package.json，确认name字段值和npm上已发布的历史包名完全一致。注意作用域包的标准格式是@<作用域（组织/用户名）>/<包名>，比如正确格式是@myorg/tool-package，不能直接写@tool-package漏写斜杠后的包名部分，名字不对先修正再走后续流程。
2. 校验账号权限：终端执行npm whoami，确认返回的账号是你用来发布包的npm账号；再执行npm owner ls <完整包名>查看包的维护者列表，如果列表里没有你的账号，找持有包管理权限的同事执行npm owner add <你的npm账号> <完整包名>，把你添加为协作者后再重试。
3. 公开包发布加对应参数：发布公开作用域包必须指定访问级别为公开，直接执行下面的命令即可：

   npm publish --access public
   

   不想每次发布都手动加参数的话，直接在package.json里加固定配置：

   "publishConfig": {
     "access": "public"
   }
   

   保存后后续执行npm publish就会默认按公开包发布，不会再触发私有包校验的404错误。

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