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-hant/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。
  • 通常發生在代理伺服器或registry設定之後。

可能原因

  • 代理伺服器設定指向不存在的東西。設定了 127.0.0.1 或其他主機上的代理伺服器,但那裡沒有執行代理伺服器。
  • 本機registry已關閉。本機鏡像或快取已停止。
  • 服務未啟用。Node.js 文件指出,這通常是因為遠端主機上的服務未啟用。
  • 呼叫本機伺服器的腳本。測試或建置步驟可能呼叫了尚未啟動的伺服器。

如何檢查

  1. 讀取錯誤中的位址和連接埠。

  2. 顯示 npm 的代理伺服器和registry。

    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. 啟動位址所指的本機registry或伺服器。

  3. 取消錯誤的代理伺服器變數。

    unset https_proxy http_proxy
  4. 重試安裝。

常見問題

ECONNREFUSED 和 ECONNRESET 一樣嗎?

不一樣。ECONNREFUSED 是一開始就被拒絕。ECONNRESET 是關閉已開啟的連線。請參閱 Mac 上的「npm error code ECONNRESET」。

為什麼它指出 127.0.0.1?

npm 嘗試了本機位址,通常來自代理伺服器或registry設定。

資料來源

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