req.body undefined di Express hampir selalu berarti body parser belum berjalan sebelum route dieksekusi. Pasang express.json() dan express.urlencoded() di atas semua route, lalu pastikan client mengirim Content-Type yang cocok. Tanpa dua hal ini, Express tidak mengisi req.body dan nilainya tetap undefined.
Penyebab Express Req Body Undefined Paling Sering
Express tidak memparsing body secara otomatis. Parser harus aktif agar data POST, PUT, dan PATCH terbaca.
- req.body vs req.query vs req.params: data form dan JSON masuk ke
req.body, parameter URL seperti?cari=kopimasuk kereq.query, segmen route seperti/user/:idmasuk kereq.params. Salah membaca sumber membuat body terlihat kosong. - Middleware belum dipasang atau urutan salah:
app.use(express.json())dipasang setelahapp.post()atau setelahapp.use(router), sehingga request tiba lebih dulu sebelum parser siap. - Content-Type tidak cocok: client mengirim JSON tanpa header
application/json, atau form HTML dikirim sebagaimultipart/form-datatanpa parser upload. - Body terbaca dua kali: parser dipasang dua kali atau stream request sudah dikonsumsi middleware lain, lalu route kedua menerima body kosong.
Tabel Diagnosis Cepat Req Body Undefined
Cocokkan gejala dengan pemeriksaan berikut sebelum mengubah kode terlalu jauh.
| Gejala | Penyebab | Pemeriksaan |
|---|---|---|
| Undefined di semua request | Parser belum dipasang | Cek app.use(express.json()) di atas route |
| Hanya form HTML kosong | Urlencoded belum aktif | Cek express.urlencoded({ extended: true }) |
| Hanya JSON kosong | Content-Type salah | Cek header request di Postman atau fetch |
| Hanya satu route bermasalah | Router dipasang sebelum parser | Cek urutan app.use(parser) dan app.use(router) |
Cara Memperbaiki Req Body Undefined Langkah per Langkah
- Pasang parser JSON dan form sebelum semua route.
- Cek
Content-Typedari client, samakan dengan parser yang dipakai. - Uji ulang dengan curl atau Postman memakai body mentah yang valid.
- Validasi
req.bodydan kembalikan status 400 bila field wajib kosong.
const express = require('express');
const app = express();
app.use(express.json());
app.use(express.urlencoded({ extended: true }));
app.post('/login', (req, res) => {
console.log(req.body);
if (!req.body.email) {
return res.status(400).json({ message: 'email wajib diisi' });
}
res.json({ diterima: req.body });
});
app.use('/api', require('./routes/api'));
app.listen(3000);
- Batasi ukuran JSON bila API publik, contoh
express.json({ limit: '1mb' }), agar request raksasa tidak membebani memori. - Gunakan
extended: truebila form mengirim data nested sepertiuser[nama]. - Form upload file dengan
enctype="multipart/form-data"membutuhkan parser upload,express.urlencodedtidak cukup.
FAQ
Kenapa req.body undefined padahal sudah pakai express.json?
Kemungkinan parser dipasang setelah route atau client tidak mengirim Content-Type: application/json.
Apakah perlu body-parser terpisah di Express baru?
Tidak, Express 4.16 ke atas sudah menyertakan express.json() dan express.urlencoded().
Kenapa form HTML mengirim body kosong ke Express?
Form default memakai urlencoded, jadi aktifkan express.urlencoded() atau periksa atribut form bila memakai multipart.