EASYBOT GUIDE

Node.js Cannot find moduleの原因と解決方法

Cannot find moduleやERR_MODULE_NOT_FOUNDが出る時に、依存関係、起動場所、ファイル名、ES Modules設定を確認する方法を紹介します。

2026年9月18日更新

Node.jsのCannot find moduleは、指定したモジュールやファイルを実行環境が見つけられない時に発生します。依存パッケージ不足だけでなく、相対パスやLinuxの大文字・小文字違いも原因になります。

パッケージ不足を確認

エラーに出たモジュール名がnpmパッケージなら、package.jsonのdependenciesに登録されているか確認します。開発環境だけに入れていると、本番環境では見つからないことがあります。

Windowsでは通るパスがLinuxでは失敗することがあります。ファイル名、拡張子、相対パスの基準ディレクトリを実際のZIP内容と照合します。

package.jsonのtypeがmoduleの場合、import/exportの規則が適用されます。requireとの混在や拡張子の省略によって読み込みに失敗することがあるため、プロジェクト内で方式をそろえます。

依存関係の再導入は時間とディスク容量を使います。まずエラーに出た名前と依存定義を調べ、毎回の再インストールが必要か確認してください。