---
title: "Mac 上的 curl: (56) Failure when receiving data · Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/curl-56-failure-receiving-data"
description: "Mac 上的 curl 以 (56) Failure when receiving data 停止。連線在傳輸期間中斷。請檢查代理伺服器、VPN 和伺服器。"
---

# 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 連不上的原因](https://kilobat.app/zh-hant/guides/recipes/why-cant-it-connect)。

## 常見問題

**(56) 和 ECONNRESET 一樣嗎？**

連線被重設是可能的原因之一。請參閱 [Mac 上的「npm error code ECONNRESET」](https://kilobat.app/zh-hant/guides/npm-econnreset)。

**這能證明伺服器有問題嗎？**

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

## 資料來源

- [curl：libcurl error codes](https://curl.se/libcurl/c/libcurl-errors.html)

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

## 相關指南

- [Mac 上的「curl: (7) Failed to connect」](https://kilobat.app/zh-hant/guides/curl-7-failed-to-connect): curl 結束代碼 7 表示某個步驟失敗。
- [Mac 上的「npm error code ECONNRESET」](https://kilobat.app/zh-hant/guides/npm-econnreset): ECONNRESET 表示連線遭強制重設。
- [Mac 版 Chrome 的 ERR_CONNECTION_RESET](https://kilobat.app/zh-hant/guides/err-connection-reset): ERR_CONNECTION_RESET 是 Chrome 的網路錯誤。
- [Mac 上的 Homebrew 失敗並顯示「curl: (28)」](https://kilobat.app/zh-hant/guides/homebrew-curl-28-timed-out): Homebrew 使用 curl 下載。
