cara mengatasi path import salah node js paling cepat adalah perbaiki relative path dari file yang memanggil, bukan dari root project. Cek stack trace baris pertama, lalu hitung ulang jumlah ../ dan pastikan huruf besar kecil serta ekstensi file sudah tepat.
Penyebab Path Import Salah di Node Js
Node.js menampilkan dua pesan berbeda untuk masalah ini. CommonJS memakai Cannot find module '...', sedangkan ES Module memakai ERR_MODULE_NOT_FOUND.
Periksa dulu sistem modul lewat package.json. Kalau "type": "module" berarti project memakai import dan export. Kalau tidak ada, project memakai require() dan module.exports.
- Salah hitung
./untuk file sefolder dan../untuk naik satu folder. - Salah huruf besar kecil, misalnya
require('./User')padahal file bernamauser.js. Linux dan server deployment bersifat case sensitive. - Ekstensi hilang pada ES Module, misalnya
import './utils'harusnyaimport './utils.js'. - Mengimpor folder tanpa
index.js, misalnyarequire('./helpers')padahal isi folder tidak punya entry file.
Tabel Diagnosis Cepat Path Import
Baca stack trace dari atas. Nama file paling atas adalah file pemanggil yang path-nya salah. Perbaiki path di file itu.
| Pesan Error | Penyebab | Solusi |
|---|---|---|
| Cannot find module ‘./db’ | File beda folder | Ubah ke ../config/db |
| ERR_MODULE_NOT_FOUND | Ekstensi hilang | Tambah .js di akhir import |
| Cannot find module ‘/utils’ | Path absolut salah | Pakai ./utils atau path.join |
Cek package.json kalau error muncul setelah ganti require ke import. Proyek ES Module wajib konsisten memakai sintaks import.
Cara Memperbaiki Path Import Salah Node Js
- Cek struktur folder dengan
lsatau file explorer. Catat posisi file pemanggil dan file tujuan. - Perbaiki relative path. Satu titik untuk sefolder, dua titik untuk naik satu level.
- Cek ekstensi dan huruf. Samakan persis nama file di disk dengan tulisan di kode.
- Jalankan ulang dengan
node index.jsdan baca error baru bila masih muncul.
// Salah CommonJS
const db = require('./config/db');
// Benar, file pemanggil ada di routes/
const db = require('../config/db');
// Salah ES Module
import { hitung } from './utils';
// Benar
import { hitung } from './utils.js';
Untuk path dinamis, hindari gabung string manual. Gunakan path.join(__dirname, 'data', 'user.json') di CommonJS. Di ES Module, __dirname tidak tersedia, gunakan import.meta.url sebagai basis path.
FAQ
Kenapa module not found padahal file ada?
Path dihitung dari file pemanggil, bukan dari root project, sehingga ./ sering menunjuk folder yang keliru.
Harus pakai extension .js di import Node Js?
Wajib pada ES Module Node.js, contohnya import './db.js'.
Bagaimana cek path import absolute vs relative?
Path relative selalu diawali ./ atau ../, selain itu Node.js menganggapnya package dari node_modules.