npm包发布新版本后官网未展示、外部用户无法安装该版本问题

1. 检查latest标签绑定状态 #

你本地能拉取到新版本、其他用户拉取不到，大概率是版本的latest标签没有正确绑定：

• 执行命令npm dist-tag ls @code-collabo/node-mongo-cli查看标签配置，正常情况返回结果中latest对应的值应为1.0.1
• 如果latest指向的是1.0.0，执行命令npm dist-tag add @code-collabo/node-mongo-cli@1.0.1 latest修正标签绑定即可

2. 排查镜像源同步延迟问题 #

• 多数用户如果配置了第三方npm镜像，这类镜像对scope包的同步频率远低于官方源，会出现新版本不同步的问题
• 可以让其他用户执行npm i -g @code-collabo/node-mongo-cli --registry=https://registry.npmjs.org临时切换官方源安装，如果能拉取到1.0.1版本，等待镜像自动同步或到对应镜像站点提交手动同步申请即可

3. 核实包公开状态 #

• 你维护的是scope包，登录npm官网进入包的设置页，确认包权限为public公开状态，没有设置私有访问限制，也没有版本被标记为弃用、下架等异常状态
• 如果设置为私有，仅你账号授权的用户可以拉取到最新版本

4. 重新发布触发缓存刷新 #

如果上述排查都无异常，可以触发重新发布刷新npm侧缓存：

• 执行npm unpublish @code-collabo/node-mongo-cli@1.0.1下架当前1.0.1版本（需满足发布后72小时内、下载量低于阈值的npm下架规则）
• 等待1-2小时后，执行npm publish --access public重新发布版本，明确指定公开权限，大部分情况二次发布即可解决官方页面不展示、缓存不同步的问题

5. 联系npm官方支持 #

如果以上操作执行后超过24小时问题依然存在，提交npm官方工单，提供包名、发布时间、npm show的查询结果截图，申请人工核实后台同步状态。

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