“npm error code ENOTFOUND” auf dem Mac
ENOTFOUND meldet eine fehlgeschlagene DNS-Abfrage. Die Node.js-Dokumentation nennt sie „DNS lookup failed“, einen Fehler von EAI_NODATA oder EAI_NONAME.
Mein Mac hat dieses Problem: „npm error code ENOTFOUND“ auf dem Mac. Lies https://kilobat.app/de/guides/npm-enotfound.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.
Symptome
npm installbricht mitnpm error code ENOTFOUNDab.- Die nächste Zeile nennt einen Host, etwa
registry.npmjs.org. - Browser funktionieren möglicherweise.
Mögliche Ursachen
- Keine Verbindung oder kein DNS. Der Mac erreicht keinen DNS-Server.
- Eine falsche Registry. Die npm-Registry-Einstellung nennt einen Host, der nicht existiert oder ein VPN braucht.
- Ein VPN mit eigenem DNS. Firmen-Registries werden nur aufgelöst, solange das VPN an ist.
- Ein Proxy, den npm nicht nutzt. In Netzwerken nur mit Proxy braucht npm die Proxy-Einstellungen.
So prüfst du es
Zeige die Registry an, die npm verwendet.
npm config get registryLöse den Hostnamen über macOS auf.
dscacheutil -q host -a name registry.npmjs.orgFrage die Registry direkt ab.
npm pingZeige die Proxy-Einstellungen an.
npm config get https-proxy
So behebst du es
Wenn die Abfrage über macOS scheitert, behebe DNS. Siehe DNS löst auf dem Mac nicht auf.
Korrigiere die Registry.
npm config set registry https://registry.npmjs.org/Verbinde das VPN für eine Firmen-Registry.
Leere den DNS-Cache. Siehe DNS-Cache auf dem Mac leeren.
Mit Kilobat
Der Verbindungsdoktor von Kilobat testet die Adresse Schicht für Schicht: Netzwerk, Proxy, DNS, Regeln, IPv4, IPv6, TLS und Server. Er nennt die Schicht, die fehlgeschlagen ist.
kilobat why https://registry.npmjs.org/Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit
diagnose_connectionunddiagnose_networkaus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.
Fragen
Ist ENOTFOUND dasselbe wie EAI_AGAIN?
Nein. EAI_AGAIN meldet eine vorübergehend fehlgeschlagene Abfrage. Siehe EAI_AGAIN auf dem Mac.
Ist mein Paketname falsch?
Selten. ENOTFOUND betrifft einen Hostnamen, keinen Paketnamen.
Quellen
Geprüft am 29. Oktober 2026.