Como Corrigir o Erro Git, fatal: The remote end hung up u…

トラブルシュート

Aprenda como corrigir o erro Git, fatal: The remote end hung up unexpectedly com nosso guia completo.

2026.01.06

Git, fatal: The remote end hung up unexpectedly – Soluções e Dicas

Visão Geral do Erro
Causas Comuns
Métodos de Solução

Visão Geral do Erro

O erro “Git, fatal: The remote end hung up unexpectedly” geralmente ocorre quando há um problema de conexão entre o seu repositório local e o repositório remoto. Esse erro pode ser causado por diversas razões, como problemas de autenticação, configurações de SSH incorretas ou até mesmo problemas com a rede.

Causas Comuns

As causas mais frequentes para esse erro incluem:

Problemas de Autenticação: Configurações incorretas de chave SSH podem impedir que você se conecte ao repositório remoto.
Conexão de Rede: Interrupções na conexão com a internet ou problemas de firewall podem causar desconexões.
Permissões Insuficientes: Tentar acessar um repositório sem as permissões necessárias pode resultar nesse erro.
URL do Repositório Incorreta: Usar a URL errada (SSH em vez de HTTPS, ou vice-versa) pode levar a esse problema.
Referências Remotas Inválidas: Tentar operar com branches remotas que não existem mais pode resultar nesse erro.

Métodos de Solução

Método 1: Configurar Chaves SSH

Um dos primeiros passos para resolver esse erro é garantir que suas chaves SSH estão configuradas corretamente.

Abra o terminal e navegue até o diretório .ssh:
bash cd ~/.ssh
Gere uma nova chave SSH, se necessário:
bash ssh-keygen -t rsa -b 4096 -C "seu_email@example.com"
Adicione sua chave SSH ao agente SSH:
bash eval $(ssh-agent -s) ssh-add ~/.ssh/id_rsa
Copie sua chave pública para a área de transferência:
bash cat id_rsa.pub | pbcopy # Para Mac cat id_rsa.pub | xclip # Para Linux
Adicione a chave ao seu perfil no GitHub ou GitLab.

Método 2: Verificar Conexões SSH

Verifique se suas conexões SSH estão funcionando corretamente.

Teste a conexão com o GitHub:
bash ssh -vT git@github.com
Teste a conexão com o GitLab:
bash ssh -vT git@gitlab.com

Se houver problemas de autenticação, você verá mensagens de erro que poderão ajudar a diagnosticar a questão.

Método 3: Verificar URL do Repositório

Certifique-se de que você está usando a URL correta para o repositório.

Verifique a URL do repositório remoto:
bash git remote -v
Caso esteja utilizando a URL SSH, tente usar a URL HTTPS ou vice-versa. Você pode alterar a URL com o seguinte comando:
“`bash
git remote set-url origin https://github.com/