Macの“npm error code ENOTFOUND”
ENOTFOUNDは、DNSの名前解決の失敗を示します。Node.jsのドキュメントでは、“DNS lookup failed”と呼ばれ、EAI_NODATAまたはEAI_NONAMEのいずれかの失敗です。
私のMacでこの問題が起きています:Macの“npm error code ENOTFOUND”。https://kilobat.app/ja/guides/npm-enotfound.mdを読んで、一緒に進めてください。Kilobat CLIがなければインストールしてください:brew install seifip/kilobat/kilobat。ガイドにあるターミナルとkilobatのチェックはあなた自身で実行し、わかったことを教えてください。私にしかできない手順は一覧にしてください。設定を変更する前に必ず確認してください。
症状
npm installがnpm error code ENOTFOUNDで止まる。- 次の行に、
registry.npmjs.orgのようなホストが表示されます。 - ブラウザでは動くことがあります。
考えられる原因
- 接続またはDNSがない。MacがDNSサーバに到達できません。
- レジストリの誤り。npmのレジストリ設定が、存在しないホスト、またはVPNが必要なホストを指しています。
- 独自のDNSを持つVPN。社内のレジストリは、VPNがオンの間だけ解決されます。
- npmが使わないプロキシ。プロキシ専用のネットワークでは、npmにプロキシ設定が必要です。
確認方法
npmが使うレジストリを表示します。
npm config get registrymacOSを通してホスト名を解決します。
dscacheutil -q host -a name registry.npmjs.orgレジストリに直接問い合わせます。
npm pingプロキシ設定を表示します。
npm config get https-proxy
解決方法
macOSでの名前検索が失敗する場合は、DNSを修正します。MacでDNSが名前解決されないをご覧ください。
レジストリを修正します。
npm config set registry https://registry.npmjs.org/社内のレジストリには、VPNを接続します。
DNSキャッシュを消去します。MacでDNSキャッシュを消去するを参照してください。
Kilobatを使う場合
Kilobatの接続ドクターは、アドレスを層ごとにテストします。ネットワーク、プロキシ、DNS、ルール、IPv4、IPv6、TLS、サーバの順です。失敗した層を示します。
kilobat why https://registry.npmjs.org/これらのKilobatのチェックは無料です。AIエージェントはMCPを通じて
diagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。
よくある質問
ENOTFOUNDはEAI_AGAINと同じですか?
いいえ。EAI_AGAINは、一時的な名前検索の失敗を示します。MacのEAI_AGAINをご覧ください。
パッケージ名が間違っているのですか?
まれです。ENOTFOUNDはホスト名に関するもので、パッケージ名ではありません。
出典
2026年10月29日に確認。