Urutkan Pengecekan saat Cara Mengatasi Npm Package Not Found di Node.Js

Cara mengatasi npm package not found paling aman mulai dari cek nama package di package.json, lalu pastikan kamu install di folder proyek yang benar. Jalankan npm ls nama-package untuk melihat statusnya. Kalau kosong, package memang belum terinstal atau salah ejaan.

Penyebab npm Package Not Found Paling Sering

Error ini jarang berarti npm rusak. Node.js tidak menemukan folder package di dalam node_modules atau tidak cocok dengan sistem modul yang kamu pakai.

  • Nama package salah ketik atau huruf besar kecilnya keliru, misalnya Express dan express terbaca beda.
  • Package belum diinstal, atau hanya tercatat di devDependencies lalu dijalankan di server production.
  • Install di folder lain, bukan root proyek tempat file package.json berada.
  • Versi Node.js beda dengan versi saat install, terutama setelah ganti versi memakai nvm.
  • Sistem modul tertukar antara CommonJS dan ES Module, sehingga require dipakai untuk package khusus import.

Tabel Diagnosis Cepat Package Not Found

Baca pesan error lengkap sebelum hapus apa pun. Lokasi error menentukan perbaikannya.

Gejala Penyebab Pemeriksaan awal
npm ERR! 404 Not Found saat install Nama salah atau package privat Cek ejaan dan registry npm
Cannot find module saat require/import Belum install atau salah folder Jalankan npm ls dan cek package.json
command not found saat npx atau CLI global Package global belum terpasang Cek npm list -g dan PATH Node.js

Cara Memperbaiki npm Package Not Found Bertahap

Ikuti urutan ini agar tidak merusak dependency lain.

  1. Periksa package.json. Pastikan nama package ada di dependencies bila dipakai production.
  2. Cek posisi folder. Jalankan perintah dari folder yang berisi package.json, bukan subfolder.
  3. Lihat status install dengan perintah berikut.
npm ls express
node -v
npm -v
  1. Install ulang package yang hilang. Untuk scoped package, tulis nama lengkap termasuk awalan organisasinya.
npm install express
npm install @namascope/namapackage
  1. Perbaiki sistem modul. Cek kolom type di package.json sebelum ubah kode.
// CommonJS
const express = require('express');

// ES Module
import express from 'express';

Pakai require dan module.exports untuk CommonJS. Pakai import dan export bila package.json berisi “type”: “module”. Package ES Module murni akan gagal bila dipanggil dengan require.

Hapus node_modules dan install ulang hanya bila struktur folder corrupt. Penghapusan package-lock.json, flag –force, dan –legacy-peer-deps bisa menyembunyikan konflik versi dan menimbulkan error lain, jadi pakai sebagai pilihan terakhir setelah backup.

FAQ

Kenapa package sudah diinstal tapi tetap not found?

Biasanya Node.js dijalankan dari folder berbeda atau sistem modulnya tertukar antara require dan import.

Apakah harus hapus node_modules dan install ulang?

Tidak selalu. Coba npm ls dan npm install biasa dulu, hapus folder hanya bila install parsial atau corrupt.

Bedanya not found saat install dengan saat require?

Not found saat install berarti registry tidak mengenali nama package, sedangkan saat require berarti package tidak ada di folder proyek lokal.