File Sudah Ada Tapi Gagal? Cara Mengatasi Module Not Found Node Js Import

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/helper padahal filenya helper.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

  1. Baca baris pertama stack trace untuk melihat modul mana yang gagal dimuat.
  2. Cek "type" di package.json untuk memastikan proyek memakai ES Module.
  3. Perbaiki path relatif dan tambah ekstensi .js pada import file lokal.
  4. Samakan sintaks, gunakan import/export untuk ES Module, bukan require/module.exports.
  5. Jika error menyebut nama package, jalankan npm install nama-package.
  6. 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.