先给结论
区分 registry 元数据、包 tarball 与安装脚本下载;后两者不一定来自同一域名。
按顺序排查
- 先打开官方状态或公告入口 https://status.npmjs.org/,确认是否有服务故障;帮助页不一定提供实时运行状态。
- 在相同出口下复现 npm 问题,记录发生时间、错误码、请求阶段与持续时间。
- 用 npm config get registry 检查源地址,再用 npm view npm version 检查元数据;保留锁文件。
- 分别测试有线 / Wi-Fi 或另一个网络;一次仅更换一个条件,排除本地无线网络拥塞。
- 如果客户端慢、浏览器正常,核对客户端代理和系统代理是否一致,避免重复代理。
- 区分 registry 元数据、包 tarball 与安装脚本下载;后两者不一定来自同一域名。
官方参考
服务规则以官方页面为准。部分公告入口为帮助页面,不代表实时状态检测。
常见问题
切换网络能解决所有 npm 问题吗?
不能。网络出口只影响连接路径。账号资格、订阅、设备限制、文件权限及平台状态需要分别核对。
应该向支持人员提供哪些信息?
提供发生时间、客户端版本、已脱敏的错误码和最小复现步骤。不要提供密码、验证码、Cookie 或完整的私有请求内容。