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 install或腳本以npm error code ECONNREFUSED停止。- 下一行會指出位址和連接埠,例如
127.0.0.1:8080。 - 通常發生在代理伺服器或registry設定之後。
可能原因
- 代理伺服器設定指向不存在的東西。設定了
127.0.0.1或其他主機上的代理伺服器,但那裡沒有執行代理伺服器。 - 本機registry已關閉。本機鏡像或快取已停止。
- 服務未啟用。Node.js 文件指出,這通常是因為遠端主機上的服務未啟用。
- 呼叫本機伺服器的腳本。測試或建置步驟可能呼叫了尚未啟動的伺服器。
如何檢查
讀取錯誤中的位址和連接埠。
顯示 npm 的代理伺服器和registry。
npm config get proxy npm config get https-proxy npm config get registry測試該連接埠。
nc -vz 127.0.0.1 8080顯示代理伺服器環境變數。
env | grep -i proxy
如何修正
刪除你不需要的代理伺服器設定。
npm config delete proxy npm config delete https-proxy啟動位址所指的本機registry或伺服器。
取消錯誤的代理伺服器變數。
unset https_proxy http_proxy重試安裝。
常見問題
ECONNREFUSED 和 ECONNRESET 一樣嗎?
不一樣。ECONNREFUSED 是一開始就被拒絕。ECONNRESET 是關閉已開啟的連線。請參閱 Mac 上的「npm error code ECONNRESET」。
為什麼它指出 127.0.0.1?
npm 嘗試了本機位址,通常來自代理伺服器或registry設定。
資料來源
查核日期:2026 年 10 月 29 日。