“curl: (56) Failure when receiving data” no Mac

O código de saída 56 do curl indica uma etapa que falhou. A documentação do curl diz: “Failure with receiving network data.”

Resolva com seu agenteCopia um prompt para o Claude Code, o Codex ou qualquer agente que possa usar o Terminal.

Meu Mac está com este problema: “curl: (56) Failure when receiving data” no Mac. Leia https://kilobat.app/pt/guides/curl-56-failure-receiving-data.md e resolva comigo. Instale a CLI do Kilobat se ela estiver faltando: brew install seifip/kilobat/kilobat. Execute você mesmo as verificações do Terminal e do kilobat do guia e me diga o que encontrar. Liste os passos que só eu posso fazer. Pergunte antes de alterar qualquer ajuste.

Aplica-se ao curl incluído no macOS e ao curl do Homebrew em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

  • O Terminal mostra curl: (56) Failure when receiving data from the peer ou uma linha parecida.
  • Um download começa e depois para.
  • O texto pode acrescentar “Connection reset by peer”.

Possíveis causas

  • Uma conexão reiniciada. Um servidor, proxy ou firewall fechou a conexão enquanto os dados fluíam.
  • Uma VPN ou uma mudança de rede. Uma reconexão da VPN ou uma mudança de Wi-Fi interrompe a transferência.
  • Um proxy que bloqueia o conteúdo. Um filtro pode cortar uma resposta que não permite.
  • Uma falha do servidor. O servidor pode falhar durante uma resposta longa.

Como verificar

  1. Execute o curl com detalhes. Anote quando a falha começa.

    curl -v https://example.com
  2. Tente de novo em outra rede, como o acesso pessoal de um celular.

  3. Mostre as variáveis de proxy.

    env | grep -i proxy
  4. Verifique o enlace Wi-Fi enquanto a transferência roda.

    kilobat wifi

Como corrigir

  1. Tente a transferência de novo. Adicione novas tentativas aos scripts.

    curl --retry 3 -O https://example.com/file.zip
  2. Desative a VPN, o proxy ou o app de segurança para um teste rápido. Ative de novo depois.

  3. Retome um download com -C -.

    curl -C - -O https://example.com/file.zip
  4. Se falhar só em uma rede, pergunte ao administrador dela sobre filtragem.

Com o Kilobat

  1. O diagnóstico de conexão do Kilobat testa o endereço camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e o servidor. Ele aponta a camada que falhou.

    kilobat why https://example.com
  2. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com diagnose_connection e diagnose_network. Consulte Descubra por que um site ou API não conecta.

Perguntas

(56) é o mesmo que ECONNRESET?

Uma conexão reiniciada é uma causa possível. Veja “npm error code ECONNRESET” no Mac.

Isso prova que o servidor tem defeito?

Não. Um dispositivo no caminho também pode fechar a conexão.

Fontes

Verificado em 29 de outubro de 2026.