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()ataures.json()tanpanext(). express.json()dipasang setelah router, akibatnya body parser belum aktif saat route membacareq.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:
- Cek urutan. Middleware global, logger, CORS, dan
express.json()wajib di atas semua route. - Cek
next(). Setiap middleware yang tidak mengirim respons harus meneruskan request. - Cek path. Uji middleware tanpa path dulu, lalu persempit dengan prefix.
- Cek error handler. Pasang di paling bawah setelah semua route dan middleware.
- Tes ulang dengan
console.logdan 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.