« npm error code ENOTFOUND » sur Mac
ENOTFOUND signale l’échec d’une résolution DNS. La documentation de Node.js l’appelle « DNS lookup failed », un échec de EAI_NODATA ou de EAI_NONAME.
Mon Mac a ce problème : « npm error code ENOTFOUND » sur Mac. Lis https://kilobat.app/fr/guides/npm-enotfound.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.
Symptômes
npm installs’arrête avecnpm error code ENOTFOUND.- La ligne suivante nomme un hôte, comme
registry.npmjs.org. - Les navigateurs peuvent fonctionner.
Causes probables
- Pas de connexion ou de DNS. Le Mac ne peut pas joindre un serveur DNS.
- Un registre incorrect. Le réglage du registre npm nomme un hôte qui n’existe pas ou qui exige un VPN.
- Un VPN avec son propre DNS. Les registres d’entreprise ne se résolvent que lorsque le VPN est actif.
- Un proxy que npm n’utilise pas. Sur les réseaux qui n’autorisent que le proxy, npm a besoin des réglages de proxy.
Comment vérifier
Affichez le registre qu’utilise npm.
npm config get registryRésolvez le nom d’hôte via macOS.
dscacheutil -q host -a name registry.npmjs.orgInterrogez directement le registre.
npm pingAffichez les réglages de proxy.
npm config get https-proxy
Comment corriger
Si la résolution via macOS échoue, réparez le DNS. Voir Le DNS ne résout pas les noms sur Mac.
Corrigez le registre.
npm config set registry https://registry.npmjs.org/Connectez le VPN pour un registre d’entreprise.
Videz le cache DNS. Consultez Vider le cache DNS sur un Mac.
Avec Kilobat
Le diagnostic de connexion de Kilobat teste l’adresse couche par couche : réseau, proxy, DNS, règles, IPv4, IPv6, TLS et serveur. Il nomme la couche qui a échoué.
kilobat why https://registry.npmjs.org/Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec
diagnose_connectionetdiagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.
Questions
ENOTFOUND est-il identique à EAI_AGAIN ?
Non. EAI_AGAIN signale un échec temporaire de résolution. Voir EAI_AGAIN sur Mac.
Le nom de mon paquet est-il faux ?
Rarement. ENOTFOUND concerne un nom d’hôte, pas un nom de paquet.
Sources
Vérifié le 29 octobre 2026.