Middleware Dilewati Express? Cara Mengatasi Express Middleware Tidak Jalan dengan Urutan Benar

Middleware Express dilewati karena Express mengeksekusi app.use() dan route sesuai urutan pendaftaran. Pindahkan middleware global ke atas, sebelum route, pastikan setiap middleware memanggil next() atau mengakhiri respons, lalu cek path-nya. Kesalahan paling sering: express.json() dipasang setelah router sehingga req.body kosong.

Penyebab Express Middleware Dilewati

Express tidak memprioritaskan jenis fungsi, ia hanya berjalan dari atas ke bawah. Request berhenti di handler pertama yang mengirim respons.

  • app.use() ditulis di bawah route, jadi request sudah dijawab route duluan.
  • Lupa memanggil next(), request menggantung dan middleware berikutnya tidak jalan.
  • Path middleware tidak cocok, misalnya app.use('/api', ...) tidak akan kena request ke /login.
  • Respons diakhiri terlalu cepat dengan res.send() atau res.json() tanpa next().
  • express.json() dipasang setelah router, akibatnya body parser belum aktif saat route membaca req.body.

Tabel Diagnosis Cepat Middleware

Pakai gejala untuk mempersempit pemeriksaan sebelum mengubah kode.

Gejala Penyebab Pemeriksaan
Hanya route pertama jalan Middleware tidak panggil next() Cek semua fungsi ada next() atau res.send()
req.body kosong express.json() di bawah router Pindah express.json() ke paling atas
Middleware path spesifik tidak kena Path salah atau prefix kurang Cek app.use(‘/api’) dan URL request
Error tidak tertangkap Error handler bukan 4 parameter Pastikan format (err, req, res, next)

Cara Memperbaiki Middleware Express yang Macet

Ikuti urutan ini agar tidak menebak-nebak:

  1. Cek urutan. Middleware global, logger, CORS, dan express.json() wajib di atas semua route.
  2. Cek next(). Setiap middleware yang tidak mengirim respons harus meneruskan request.
  3. Cek path. Uji middleware tanpa path dulu, lalu persempit dengan prefix.
  4. Cek error handler. Pasang di paling bawah setelah semua route dan middleware.
  5. Tes ulang dengan console.log dan kirim request lewat curl atau Postman.
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('/users', (req, res) => {
  res.json({ ok: true });
});

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

FAQ

Kenapa next() wajib dipanggil di middleware?

Karena next() meneruskan request ke middleware atau route berikutnya, tanpanya request berhenti dan menggantung.

Kenapa app.use harus di atas route?

Karena Express berjalan berurutan dari atas ke bawah, middleware di bawah route tidak sempat dieksekusi.

Kenapa error handler Express butuh 4 parameter?

Karena Express mengenali error handler dari jumlah parameter (err, req, res, next), kurang dari itu dianggap middleware biasa.