Req.Body Selalu Kosong? Cara Mengatasi Express Req Body Undefined

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=kopi masuk ke req.query, segmen route seperti /user/:id masuk ke req.params. Salah membaca sumber membuat body terlihat kosong.
  • Middleware belum dipasang atau urutan salah: app.use(express.json()) dipasang setelah app.post() atau setelah app.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 sebagai multipart/form-data tanpa 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

  1. Pasang parser JSON dan form sebelum semua route.
  2. Cek Content-Type dari client, samakan dengan parser yang dipakai.
  3. Uji ulang dengan curl atau Postman memakai body mentah yang valid.
  4. Validasi req.body dan 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: true bila form mengirim data nested seperti user[nama].
  • Form upload file dengan enctype="multipart/form-data" membutuhkan parser upload, express.urlencoded tidak 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.