Module saling require membuat salah satu hasil require berisi objek kosong atau undefined. Cara mengatasi circular dependency Node.js yang benar adalah memutus siklusnya: pindahkan logika bersama ke file ketiga, lalu restart proses Node.js untuk memastikan urutan load bersih.
Node.js tidak selalu menampilkan error jelas. Aplikasi tetap jalan, tetapi fungsi hilang sebagian dan perilaku berubah tergantung file mana dimuat duluan.
Penyebab Circular Dependency di Node.js
Pada CommonJS, a.js memanggil require('./b') sementara b.js memanggil require('./a'). Saat siklus terjadi, Node.js mengembalikan objek module.exports yang belum selesai diisi.
Pada ES Module, import saling silang memakai live binding. Kode bisa terbaca, tetapi nilai yang diakses saat evaluasi awal masih belum terinisialisasi.
- Fungsi dari file tetangga menjadi
undefinedpadahal file ada. console.log(require('./a'))menampilkan{}sebagian.- Hasil berbeda saat entry point diubah dari
index.jske file lain. - Error muncul hanya pada request tertentu, bukan saat startup.
Lacak sumbernya dari stack trace saat error terjadi. Untuk proyek besar, jalankan npx madge --circular src/index.js agar daftar siklus tampil tanpa memeriksa file satu per satu.
Tabel Troubleshooting Circular Dependency
| Gejala | Penyebab | Cek cepat yang dilakukan |
|---|---|---|
| Exports kosong sebagian | Require melingkar di CommonJS | Periksa urutan require dari entry point |
| Cannot access before initialization | Import saling silang di ES Module | Periksa nilai yang dipakai saat modul dievaluasi |
| Error hilang-timbul | Urutan load berubah | Uji dengan dua entry point berbeda |
Cara Memperbaiki Circular Dependency Node Js
Langkah paling aman adalah menghilangkan siklus, bukan menyembunyikannya.
- Pindahkan fungsi atau konstanta bersama ke file ketiga, misalnya
shared.js. - Ubah akses langsung menjadi injeksi dependency melalui parameter fungsi.
- Ganti event lintas modul bila dua file hanya perlu memberi kabar, bukan saling memakai isi.
- Pakai lazy require hanya sebagai perbaikan sementara di dalam fungsi.
- Restart Node.js dan uji ulang alur yang sebelumnya gagal.
// shared.js
function formatNama(nama) {
return String(nama).trim();
}
module.exports = { formatNama };
// a.js
const { formatNama } = require('./shared');
module.exports = { formatNama };
// shared.js
export function formatNama(nama) {
return String(nama).trim();
}
// a.js
import { formatNama } from './shared.js';
export { formatNama };
Contoh lazy require untuk CommonJS:
function simpan() {
const db = require('./db');
return db.simpanData();
}
FAQ
Apakah circular dependency selalu bikin error?
Tidak. Aplikasi bisa tetap jalan, tetapi sebagian exports kosong atau bernilai lama.
Kapan lazy require boleh dipakai?
Boleh sebagai jalan pintas sementara ketika require hanya dibutuhkan saat fungsi dipanggil, bukan saat file dimuat.
Apakah memecah file selalu menyelesaikan masalah?
Tidak, kecuali bagian yang dipakai bersama benar-benar pindah ke modul independen tanpa siklus baru.