Mensagens de erro

“npm error code ECONNRESET” no Mac

ECONNRESET informa uma conexão encerrada à força. Ele não identifica a origem do encerramento. A documentação do Node.js o chama de “Connection reset by peer”.

Aplica-se ao npm 10 e posteriores, que mostram “npm error”. Versões anteriores mostram “npm ERR!”. Todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

npm install para com npm error code ECONNRESET.
O npm acrescenta que isso é um problema relacionado à conectividade de rede.
Isso acontece em uma rede corporativa, VPN ou com um app de segurança.

Possíveis causas

Um proxy ou filtro que interrompe conexões. Um proxy corporativo ou software de segurança pode encerrar conexões que não permite.
Inspeção TLS. Um proxy que inspeciona tráfego seguro pode interromper a conexão. Consulte Certificados de proxy corporativo prejudicam ferramentas do Terminal no Mac.
Uma VPN que se reconecta. Conexões que passam pela VPN são encerradas quando ela se reconecta.
Uma conexão instável. A documentação do Node.js informa que um tempo limite ou reinicialização no lado remoto pode causar isso.

Como verificar

Mostre os ajustes de registro e proxy do npm.

npm config get registry
npm config get proxy
npm config get https-proxy

Peça uma resposta ao registro.
```
npm ping
```

Teste o registro com curl. Procure o emissor do certificado.

curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer

Tente a instalação em outra rede, como o acesso pessoal de um telefone.

Como corrigir

Se a rede precisar de proxy, configure-o para o npm.

npm config set https-proxy http://proxy.example.com:8080

Se um proxy corporativo inspecionar TLS, adicione seu certificado raiz para o Node.js. Consulte Certificados de proxy corporativo prejudicam ferramentas do Terminal no Mac.
Configure mais tentativas para o npm.
```
npm config set fetch-retries 5
```
Se houver uma VPN, proxy ou app de segurança ativo, desative-o para um teste breve. Ative-o novamente após o teste.

Com o Kilobat

O diagnóstico de conexão do Kilobat testa o registro camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e servidor. Ele identifica a camada que falhou.
```
kilobat why https://registry.npmjs.org/
```
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

ECONNRESET é um erro do meu projeto?

Geralmente não. A conexão ao registro foi encerrada. Execute a mesma instalação em outra rede para comparar.

ECONNRESET é o mesmo que um tempo esgotado?

Não. ECONNRESET indica que a conexão foi interrompida. Um tempo limite esgotado informa que uma operação não terminou a tempo.

Fontes

Documentação do Node.js: erros de sistema comuns
intro(2), ECONNRESET, página de manual instalada com o macOS 27.2
Documentação do npm: config
curl(1), página de manual instalada com o macOS 27.2

Verificado em 29 de outubro de 2026.