Cara mengatasi Express route tidak terbaca paling cepat adalah cek urutan app.use(), prefix mounting, dan export router. Pindahkan handler 404 ke baris paling akhir, pastikan app.use('/api/users', userRoutes) cocok dengan path yang diuji, lalu restart server Node.js.
Penyebab Express Route Tidak Terbaca Paling Sering
Express memproses request dari atas ke bawah. Satu baris salah tempat membuat semua route di bawahnya tidak pernah dieksekusi.
- Middleware 404 dipasang terlalu awal sehingga memotong route yang belum sempat didaftarkan.
- Salah mounting path, contoh router berisi
/profiletapi di-mount ke/apilalu diuji ke/profiletanpa prefix. - Router tidak di-export atau salah sistem module, contoh pakai
module.exportsdi file ES Module. - Method dan path tidak cocok, contoh daftar
router.post()tapi diuji dengan GET, atau kirim ID lewatreq.querypadahal route memakaireq.params.
Tabel Diagnosis Cepat Route 404
Cek daftar route aktif dengan app._router.stack sebelum menebak penyebabnya.
| Gejala | Penyebab | Solusi |
|---|---|---|
| Semua route 404 | Handler 404 di atas route | Pindah 404 ke akhir |
| Router modular 404 | Salah prefix mount | Samakan mount dan uji |
| Method tertentu 404 | GET diuji ke POST | Samakan method client |
| Route login tertutup | Auth di depan route publik | Kecualikan route publik |
Cara Memperbaiki Express Route Tidak Terbaca
Ikut urutan ini agar perbaikan tidak acak:
- Buka file router, pastikan akhir file memakai
module.exports = routeruntuk CommonJS. - Buka
app.js, perbaiki require dan mounting:const userRoutes = require('./routes/user')laluapp.use('/api/users', userRoutes). - Susun urutan:
express.json(), route API, lalu handler 404 dan error handler di paling bawah. - Restart server dan uji tiap method dengan curl atau Postman, termasuk slash akhir seperti
/api/users/.
const express = require('express');
const userRoutes = require('./routes/user');
const app = express();
app.use(express.json());
app.use('/api/users', userRoutes);
app.use((req, res) => res.status(404).json({ message: 'Route tidak ditemukan' }));
app.listen(3000);
const express = require('express');
const router = express.Router();
router.get('/:id', (req, res) => {
res.json({ id: req.params.id });
});
module.exports = router;
FAQ
Kenapa route baru tetap 404 setelah server restart?
File yang dijalankan Node.js berbeda dengan file yang diedit, cek kembali path entry di package.json.
Apakah urutan app.use memengaruhi route Express?
Ya, Express berhenti di middleware pertama yang merespons, jadi route harus di atas handler 404.
Kenapa router modular tidak terbaca padahal path sudah benar?
Router belum di-mount di app.js atau export-nya salah antara CommonJS dan ES Module.