Mac 上的「curl: (56) Failure when receiving data」

curl 結束代碼 56 表示某個步驟失敗。curl 文件寫道:「Failure with receiving network data.」

讓你的代理程式來解決拷貝一則提示詞,適用於 Claude Code、Codex 或任何能使用終端機的代理程式。

我的 Mac 出現了這個問題:Mac 上的「curl: (56) Failure when receiving data」。請閱讀 https://kilobat.app/zh-hant/guides/curl-56-failure-receiving-data.md,並和我一起逐步處理。如果缺少 Kilobat CLI,請安裝:brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於:macOS 內建的 curl 和 Homebrew 的 curl,所有目前的 macOS 版本。檢查日期:2026年10月29日

症狀

  • 「終端機」顯示 curl: (56) Failure when receiving data from the peer 或類似的一行。
  • 下載開始後就停了。
  • 訊息後面可能加上「Connection reset by peer」。

可能原因

  • 連線被重設。伺服器、代理伺服器或防火牆在資料傳輸期間關閉了連線。
  • VPN 或網路變更。VPN 重新連線或 Wi-Fi 切換會中斷傳輸。
  • 代理伺服器阻擋內容。過濾器可能會切斷它不允許的回應。
  • 伺服器故障。伺服器可能在很長的回應中途失敗。

如何檢查

  1. 用詳細模式執行 curl。留意失敗是從什麼時候開始的。

    curl -v https://example.com
  2. 換一個網路重試,例如手機熱點。

  3. 顯示代理伺服器環境變數。

    env | grep -i proxy
  4. 傳輸進行時,檢查 Wi-Fi 連結。

    kilobat wifi

如何修正

  1. 重試傳輸。在腳本中加入重試。

    curl --retry 3 -O https://example.com/file.zip
  2. 暫時關閉 VPN、代理伺服器或資安 App 來測試,之後再重新開啟。

  3. 用 -C - 接續下載。

    curl -C - -O https://example.com/file.zip
  4. 如果只在某個網路上失敗,請向該網路的管理員詢問過濾規則。

使用 Kilobat

  1. Kilobat 的連線診斷會逐層測試位址:網路、代理伺服器、DNS、規則、IPv4、IPv6、TLS 和伺服器。它會指出失敗的那一層。

    kilobat why https://example.com
  2. 這些 Kilobat 檢查都是免費的。AI 代理程式可透過 MCP 以 diagnose_connection 和 diagnose_network 執行。請參閱找出某個網站或 API 連不上的原因。

常見問題

(56) 和 ECONNRESET 一樣嗎?

連線被重設是可能的原因之一。請參閱 Mac 上的「npm error code ECONNRESET」。

這能證明伺服器有問題嗎?

不能。路徑上的其他裝置也可能關閉連線。

資料來源

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