先给结论

区分 registry 元数据、包 tarball 与安装脚本下载;后两者不一定来自同一域名。

按顺序排查

  1. 先打开官方状态或公告入口 https://status.npmjs.org/,确认是否有服务故障;帮助页不一定提供实时运行状态。
  2. 在相同出口下复现 npm 问题,记录发生时间、错误码、请求阶段与持续时间。
  3. 用 npm config get registry 检查源地址,再用 npm view npm version 检查元数据;保留锁文件。
  4. 分别测试有线 / Wi-Fi 或另一个网络;一次仅更换一个条件,排除本地无线网络拥塞。
  5. 如果客户端慢、浏览器正常,核对客户端代理和系统代理是否一致,避免重复代理。
  6. 区分 registry 元数据、包 tarball 与安装脚本下载;后两者不一定来自同一域名。

官方参考

服务规则以官方页面为准。部分公告入口为帮助页面,不代表实时状态检测。

常见问题

切换网络能解决所有 npm 问题吗?

不能。网络出口只影响连接路径。账号资格、订阅、设备限制、文件权限及平台状态需要分别核对。

应该向支持人员提供哪些信息?

提供发生时间、客户端版本、已脱敏的错误码和最小复现步骤。不要提供密码、验证码、Cookie 或完整的私有请求内容。