You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

NPM安装包遇npm ERR! network getaddrinfo ENOTFOUND错误,求验证代理及解决方法

解决npm安装时getaddrinfo ENOTFOUND报错的方案

一、验证代理URL是否正确

  • 用curl测试代理连通性:
    执行命令 curl -x http://your-proxy-url:port https://registry.npmjs.org,如果能返回npm registry的JSON数据,说明代理URL有效;若出现超时、连接失败等报错,说明代理地址、端口有误,或代理本身不可用。
    如果是SOCKS代理,改用命令 curl --socks5 your-proxy-url:port https://registry.npmjs.org 测试。
  • 核对npm代理配置:
    执行 npm config get proxy 和 npm config get https-proxy,检查输出的URL是否和你设置的一致,注意区分HTTP和HTTPS代理的配置,不要混淆。
  • 手动验证代理可用性:
    对于HTTP代理,直接在浏览器输入代理地址(如http://proxy.example.com:8080),查看是否能正常访问(部分代理会显示验证页面或返回合法状态码)。

二、其他可行解决措施

  • 临时关闭代理测试:
    执行 npm config delete proxy 和 npm config delete https-proxy 清除npm代理配置,再尝试npm install,如果报错消失,说明问题出在代理配置上。
  • 切换npm源:
    将默认源替换为国内镜像,执行 npm config set registry https://registry.npmmirror.com,多数情况下官方源访问不畅会导致类似网络报错,和代理无关。
  • 检查本地网络连通性:
    尝试用ping registry.npmjs.org测试DNS解析和网络连通性;或直接在浏览器打开https://registry.npmjs.org,确认外网访问正常。
  • 清除DNS缓存:
    Windows系统执行 ipconfig /flushdns,Mac系统执行 sudo dscacheutil -flushcache,Linux系统执行 sudo systemd-resolve --flush-caches,解决DNS解析失败导致的ENOTFOUND问题。
  • 排查防火墙/杀毒软件:
    临时关闭本地防火墙、杀毒软件后重试npm安装,确认是否是这类软件拦截了npm的网络请求。
  • 重新安装npm:
    执行 npm install -g npm@latest 更新到最新版npm;若仍有问题,卸载当前node.js和npm,重新下载官方安装包安装,排除程序损坏的可能。

内容的提问来源于stack exchange,提问作者Shanikiran Nimbalkar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.26 00:52:18