“npm error code ENOTFOUND” no Mac
ENOTFOUND indica uma consulta de DNS que falhou. A documentação do Node.js a chama de “DNS lookup failed”, uma falha de EAI_NODATA ou de EAI_NONAME.
Meu Mac está com este problema: “npm error code ENOTFOUND” no Mac. Leia https://kilobat.app/pt/guides/npm-enotfound.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 installpara comnpm error code ENOTFOUND.- A linha seguinte indica um host, como
registry.npmjs.org. - Os navegadores podem funcionar.
Possíveis causas
- Sem conexão ou DNS. O Mac não consegue alcançar um servidor DNS.
- Um registro incorreto. O ajuste de registro do npm indica um host que não existe ou que exige uma VPN.
- Uma VPN com DNS próprio. Registros da empresa só são resolvidos enquanto a VPN está ligada.
- Um proxy que o npm não usa. Em redes que só funcionam por proxy, o npm precisa dos ajustes de proxy.
Como verificar
Mostre o registro que o npm usa.
npm config get registryResolva o nome do host pelo macOS.
dscacheutil -q host -a name registry.npmjs.orgConsulte o registro diretamente.
npm pingMostre os ajustes de proxy.
npm config get https-proxy
Como corrigir
Se a consulta do macOS falhar, corrija o DNS. Veja DNS não resolve no Mac.
Corrija o registro.
npm config set registry https://registry.npmjs.org/Conecte a VPN para um registro da empresa.
Limpe o cache DNS. Consulte Limpe o cache DNS no Mac.
Com o Kilobat
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://registry.npmjs.org/Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com
diagnose_connectionediagnose_network. Consulte Descubra por que um site ou API não conecta.
Perguntas
ENOTFOUND é o mesmo que EAI_AGAIN?
Não. EAI_AGAIN indica uma falha temporária de consulta. Veja EAI_AGAIN no Mac.
O nome do meu pacote está errado?
Raramente. ENOTFOUND diz respeito a um nome de host, não a um nome de pacote.
Fontes
Verificado em 29 de outubro de 2026.