Error module not found walau file sudah ada hampir selalu soal path atau sistem modul, bukan file hilang. Node.js membedakan CommonJS dan ES Module, dan import menuntut path relatif lengkap dengan ekstensi file. Perbaiki tiga hal ini dulu sebelum install ulang dependency.
Penyebab Module Not Found saat Pakai Import di Node.js
Node.js membaca import secara ketat. Salah satu titik, salah besar kecil huruf, atau salah jenis modul langsung memicu error.
- Path relatif salah, misalnya kurang
./atau salah naik folder dengan../. - Ekstensi tidak ditulis, misalnya
./utils/helperpadahal filenyahelper.js. - Proyek masih CommonJS tetapi kode memakai
import, atau sebaliknya. - Nama file beda huruf besar kecil, fatal saat deploy ke Linux.
- Package npm memang belum terpasang di
node_modules.
Cek package.json. Nilai "type": "module" berarti proyek memakai ES Module dan import berlaku. Tanpa nilai itu, Node.js memakai CommonJS dengan require().
| Masalah | Penyebab | Solusi |
|---|---|---|
| Import file lokal gagal | Path atau ekstensi salah | Tambah ./ dan .js |
| SyntaxError Unexpected token | Campur import dan CommonJS |
Samakan type dan sintaks |
| Cannot find package | Dependency belum diinstal | Jalankan npm install |
Cara Memperbaiki Import Module Not Found Sampai Jalan
- Baca baris pertama stack trace untuk melihat modul mana yang gagal dimuat.
- Cek
"type"dipackage.jsonuntuk memastikan proyek memakai ES Module. - Perbaiki path relatif dan tambah ekstensi
.jspada import file lokal. - Samakan sintaks, gunakan
import/exportuntuk ES Module, bukanrequire/module.exports. - Jika error menyebut nama package, jalankan
npm install nama-package. - Jalankan ulang aplikasi dengan
node index.js.
- File lokal satu folder:
import { hitung } from './hitung.js'; - File beda folder:
import db from '../config/db.js'; - Package npm:
import express from 'express';
import fs from 'fs';
import { konekDb } from './config/db.js';
import express from 'express';
FAQ
Kenapa import tanpa .js menyebabkan module not found?
Resolver ES Module di Node.js tidak menebak ekstensi seperti bundler, jadi ./data.js wajib ditulis lengkap.
Apakah require bisa dipakai bersama import?
Bisa dengan dynamic import() atau pengaturan khusus, tetapi satu file sebaiknya memakai satu sistem modul agar konsisten.
Kapan perlu npm install ulang saat module not found?
Hanya bila error menyebut nama package npm atau foldernya memang tidak ada di node_modules.