KB: Erro do Git "Falha ao gravar o cabeçalho do bloco" ao salvar no workspace

A365 A365
Os usuários podem encontrar o erro “Erro do Git: falha ao gravar o cabeçalho do bloco: a conexão com o servidor foi encerrada de forma anormal” ao fazer commit de um projeto no workspace, impedindo que as alterações sejam salvas. Esse problema geralmente é causado por um repositório Git oculto em um diretório pai ou por um proxy WinHTTP configurado incorretamente. Para resolvê-lo, os usuários devem verificar a estrutura de pastas em busca de repositórios Git conflitantes e redefinir quaisquer configurações de proxy desatualizadas. Fazer um novo checkout do projeto em um diretório limpo também pode servir como solução alternativa.

Detalhes da solução

Mensagem de erro e impacto

Ao fazer commit de um projeto no Workspace, o seguinte erro pode aparecer:

Isso impede que as alterações sejam salvas no Workspace.

Causa raiz do erro

Esse problema geralmente ocorre por um dos seguintes motivos:

  • Existe uma pasta .git de nível superior em um diretório pai fora do diretório do projeto.
  • Uma configuração de proxy WinHTTP desatualizada ou oculta está interferindo nas operações do Git.

Soluções disponíveis

  • Redefinição do WinHTTP
  • Pasta Git no diretório pai
  • Novo checkout

Redefinição do WinHTTP

Esse erro pode ser causado por uma configuração de proxy oculta ou desatualizada nas configurações do WinHTTP do sistema. Para verificar e redefinir o proxy:

  1. Abra o Prompt de Comando com privilégios de administrador.
  2. Digite netsh e pressione Enter.
  3. No prompt netsh>, digite winhttp show proxy para visualizar a configuração atual do proxy.
  4. Se houver um proxy listado, digite netsh winhttp reset proxy para removê-lo.

Pasta Git no diretório pai

Verifique se existem pastas .git fora do diretório do projeto. Por exemplo, se o projeto estiver localizado em: C:\Documents\Altium\Project_A


A pasta .git deve existir apenas dentro de Project_A. Se houver uma pasta .git em Documents, Altium ou diretamente em C:\, o Git poderá tratá-la como um repositório pai, causando conflitos.

Novo checkout

Se o problema persistir, faça um novo checkout do projeto:

  1. Acesse Arquivo » Abrir projeto.
  2. Escolha Workspace.
  3. Selecione o projeto e clique no menu suspenso ao lado do botão Abrir.
  4. Escolha um caminho personalizado para o checkout e selecione Criar uma segunda cópia.
  5. Copie os arquivos modificados do diretório original para a nova pasta de checkout, substituindo os arquivos existentes.
  6. Abra o projeto na nova pasta no Altium Designer.
  7. Faça commit e push dos arquivos, um de cada vez.

Consulte Abrir projetos no Altium Designer para obter mais detalhes.

Ativar o recarregamento automático

Certifique-se de que o Recarregamento automático esteja ativado para arquivos modificados:

  • Acesse Preferências » Sistema » Geral.
  • Ative Recarregar documentos modificados fora do Altium Designer.

Ajuda da equipe de TI

Se nenhuma das etapas acima resolver o problema, entre em contato com sua equipe de TI para investigar possíveis interferências do proxy ou do antivírus.

Leitura complementar

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.