Mac 上的“npm error code ECONNREFUSED”

ECONNREFUSED 表示连接被拒绝。Node.js 文档的说法是:“No connection could be made because the target machine actively refused it.”

让你的智能体来解决拷贝一条提示词,适用于 Claude Code、Codex 或任何能使用终端的智能体。

我的 Mac 出现了这个问题:Mac 上的“npm error code ECONNREFUSED”。请阅读 https://kilobat.app/zh-hans/guides/npm-econnrefused.md,并和我一起逐步处理。如果缺少 Kilobat CLI,请安装:brew install seifip/kilobat/kilobat。请你自己运行指南中的终端和 kilobat 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。

适用于:npm 10 及更高版本打印“npm error”,更早的版本打印“npm ERR!”。所有当前 macOS 版本上的 Node.js。核查日期:2026年10月29日

症状

  • npm install 或某个脚本以 npm error code ECONNREFUSED 停止。
  • 下一行会给出一个地址和端口,例如 127.0.0.1:8080。
  • 它常常出现在代理或软件源设置之后。

可能的原因

  • 指向空处的代理设置。设置了 127.0.0.1 或其他主机上的代理,但那里并没有运行代理。
  • 未启动的本地软件源。本地镜像或缓存已停止。
  • 未启用的服务。Node.js 文档说明,这通常是远程主机上的服务未启用造成的。
  • 调用本地服务器的脚本。测试或构建步骤可能调用了尚未启动的服务器。

如何检查

  1. 查看错误中的地址和端口。

  2. 显示 npm 的代理和软件源。

    npm config get proxy
    npm config get https-proxy
    npm config get registry
  3. 测试那个端口。

    nc -vz 127.0.0.1 8080
  4. 显示代理环境变量。

    env | grep -i proxy

如何修复

  1. 删除你用不到的代理设置。

    npm config delete proxy
    npm config delete https-proxy
  2. 启动该地址所指的本地软件源或服务器。

  3. 取消设置错误的代理变量。

    unset https_proxy http_proxy
  4. 重试安装。

常见问题

ECONNREFUSED 和 ECONNRESET 一样吗?

不一样。ECONNREFUSED 是在开始时被拒绝。ECONNRESET 是关闭一个已打开的连接。参见Mac 上的“npm error code ECONNRESET”。

为什么提到的是 127.0.0.1?

npm 尝试了本地地址,通常来自代理或软件源设置。

参考资料

核查日期:2026 年 10 月 29 日。