Cara Mengatasi Express Error Middleware Tidak Terpanggil dengan Cek Urutan Next

Middleware Express tidak terpanggil hampir selalu karena urutan app.use() salah atau rantai berhenti sebelum mencapai middleware tersebut. Pindahkan middleware ke atas route, pastikan next() dipanggil, dan letakkan error handler paling bawah.

Express menjalankan middleware berurutan dari atas ke bawah. Satu response yang terkirim lebih dulu atau satu fungsi yang lupa memanggil next() cukup untuk menghentikan semua middleware di bawahnya.

Penyebab Middleware Express Tidak Terpanggil

Kasus paling sering adalah logger atau express.json() dipasang setelah app.get() atau app.post(). Route yang cocok langsung mengirim response, sehingga middleware di bawahnya tidak pernah dilewati.

  • Middleware dipasang setelah route atau setelah res.send() dipanggil.
  • Lupa memanggil next() di middleware biasa, rantai berhenti diam.
  • Lupa memanggil next(err) di blok async, error hilang tanpa response.
  • Path tidak cocok, contoh app.use(‘/api’) tidak menangkap request ke /login.
  • Error handler ditulis 3 argumen atau ditaruh di tengah, Express menganggapnya middleware biasa.

Contoh urutan salah:

app.get('/user', (req, res) => {
  res.json({ ok: true });
});
app.use((req, res, next) => {
  console.log(req.url);
  next();
});

Logger di atas tidak akan pernah jalan untuk /user karena response sudah dikirim sebelumnya.

Tabel Diagnosis Cepat Middleware Dilewati

Gejala Penyebab Cek Cepat
Logger tidak tampil Posisi di bawah route Tambah console.log di tiap middleware
req.body undefined express.json belum jalan Cek req.body setelah json parser
Error handler diam Argumen kurang atau posisi salah Pastikan format err, req, res, next
Middleware path dilewati Path atau method beda Cek req.url dan method aktual

Baca stack trace dari atas untuk menemukan file dan baris yang melempar error. Bedakan tiga jenis ini: route menangani path spesifik, middleware biasa memakai 3 argumen req, res, next, error handling memakai 4 argumen err, req, res, next.

Cara Memperbaiki Middleware agar Dieksekusi Lagi

  1. Pindahkan app.use(express.json()) dan logger ke paling atas, tepat setelah inisialisasi app.
  2. Perbaiki path middleware. Gunakan app.use() tanpa path untuk global, atau samakan prefix route.
  3. Tambahkan next() di akhir setiap middleware biasa dan next(err) di dalam catch.
  4. Pindahkan error handler ke paling bawah setelah semua route.
  5. Validasi req.body, req.query, dan req.params setelah parser jalan.
const express = require('express');
const app = express();

app.use(express.json());

app.use((req, res, next) => {
  console.log(req.method, req.url);
  next();
});

app.get('/user', (req, res) => {
  res.json({ query: req.query });
});

app.use((err, req, res, next) => {
  console.error(err.message);
  res.status(500).json({ error: 'Terjadi kesalahan server' });
});

app.listen(3000);

FAQ

Kenapa next() wajib dipanggil di middleware Express?

Tanpa next(), Express berhenti di middleware tersebut dan request menggantung sampai timeout.

Di mana posisi error handler Express yang benar?

Taruh paling bawah setelah semua route dan middleware, dengan signature lengkap (err, req, res, next).

Kenapa app.use dengan path tidak jalan?

Request tidak masuk prefix path tersebut atau method berbeda, sehingga Express melewatinya ke middleware berikutnya.