Req.Body Tiba-Tiba {}? Cara Mengatasi Express Json Body Kosong dari Urutan Middleware

Pasang app.use(express.json()) di baris paling atas, sebelum semua route. Itu penyebab paling umum cara mengatasi express json body kosong karena Express tidak memparsing body kalau middleware JSON belum jalan saat request masuk.

Penyebab Express Json Body Terbaca Kosong

Body kosong hampir selalu soal urutan dan header, bukan bug Express. Cek empat titik ini dulu:

  • express.json() belum dipasang, atau dipasang setelah app.post() sehingga route jalan duluan.
  • Pengirim tidak memakai Content-Type: application/json. Ini sering terjadi di Postman, fetch, dan axios.
  • Body sudah dibaca parser lain, misalnya hanya express.urlencoded() atau express.raw().
  • app.use dipasang di router yang salah, misalnya hanya di app tapi route ada di router terpisah.

Jangan tertukar: req.body berisi payload POST/PUT/PATCH, req.query berisi ?nama=budi, req.params berisi /user/:id.

Tabel Diagnosis Cepat Json Body Kosong

Kenali gejalanya sebelum mengubah kode:

  • req.body hasilnya {}: parser jalan, tapi isi tidak terbaca. Curigai Content-Type atau JSON tidak valid.
  • req.body hasilnya undefined: express.json() belum aktif untuk route tersebut.
  • Body terbaca di Postman tapi kosong dari frontend: fetch/axios lupa header atau lupa JSON.stringify().
Gejala Penyebab Cek Cepat
{} Content-Type salah Lihat header request
undefined Middleware terlewat Cek urutan app.use
Hanya form terbaca Hanya urlencoded Tambah express.json

Cara Memperbaiki Express Json Body Kosong

  1. Pasang app.use(express.json()) paling atas, sebelum route.
  2. Pastikan pengirim memakai Content-Type: application/json.
  3. Uji dengan curl atau Postman memakai raw JSON.
  4. Validasi req.body sebelum dipakai agar error jelas.
// CommonJS
const express = require('express');
const app = express();

app.use(express.json());

app.post('/api/user', (req, res) => {
  if (!req.body || !req.body.nama) {
    return res.status(400).json({ error: 'nama wajib diisi' });
  }
  res.json({ diterima: req.body });
});

app.listen(3000);
// ES Module, package.json pakai "type": "module"
import express from 'express';
const app = express();

app.use(express.json());

app.post('/api/user', (req, res) => {
  if (!req.body || !req.body.nama) {
    return res.status(400).json({ error: 'nama wajib diisi' });
  }
  res.json({ diterima: req.body });
});

app.listen(3000);

Contoh body uji valid:

{"nama": "Budi"}
Tahap Tindakan Catatan
1 Pasang express.json Harus sebelum route
2 Cek Content-Type Wajib application/json
3 Uji curl/Postman Pakai mode raw JSON
4 Validasi req.body Kembalikan 400 bila kosong

FAQ

Kenapa req.body tetap {} padahal express.json sudah dipasang?

Biasanya Content-Type pengirim bukan application/json atau posisi middleware masih di bawah route.

Apakah urutan express.json dan route memengaruhi hasil?

Ya, Express menjalankan middleware berurutan sehingga route di atas express.json() tidak menerima body yang sudah diparsing.

Bagaimana cek Content-Type pengirim JSON sudah benar?

Lihat tab Headers di Postman atau DevTools browser, pastikan nilainya persis application/json.