“npm error code ECONNREFUSED” no Mac
ECONNREFUSED indica uma conexão recusada. A documentação do Node.js diz: “No connection could be made because the target machine actively refused it.”
Meu Mac está com este problema: “npm error code ECONNREFUSED” no Mac. Leia https://kilobat.app/pt/guides/npm-econnrefused.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.
Sintomas
npm installou um script para comnpm error code ECONNREFUSED.- A linha seguinte indica um endereço e uma porta, como
127.0.0.1:8080. - Costuma vir depois de um ajuste de proxy ou de registro.
Possíveis causas
- Um ajuste de proxy que aponta para o nada. Um proxy em
127.0.0.1ou em outro host está definido, mas nenhum proxy roda lá. - Um registro local desligado. Um espelho ou cache local está fora do ar.
- Um serviço inativo. A documentação do Node.js diz que isso geralmente resulta de um serviço inativo no host remoto.
- Um script que chama um servidor local. Uma etapa de teste ou de build pode chamar um servidor que não foi iniciado.
Como verificar
Leia o endereço e a porta no erro.
Mostre o proxy e o registro do npm.
npm config get proxy npm config get https-proxy npm config get registryTeste essa porta.
nc -vz 127.0.0.1 8080Mostre as variáveis de proxy.
env | grep -i proxy
Como corrigir
Apague um ajuste de proxy de que você não precisa.
npm config delete proxy npm config delete https-proxyInicie o registro ou servidor local que o endereço indica.
Remova variáveis de proxy incorretas.
unset https_proxy http_proxyTente a instalação de novo.
Perguntas
ECONNREFUSED é o mesmo que ECONNRESET?
Não. ECONNREFUSED é uma recusa no início. ECONNRESET encerra uma conexão aberta. Veja “npm error code ECONNRESET” no Mac.
Por que ele indica 127.0.0.1?
O npm tentou um endereço local, geralmente por causa de um ajuste de proxy ou de registro.
Fontes
Verificado em 29 de outubro de 2026.