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 setelahapp.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()atauexpress.raw(). app.usedipasang di router yang salah, misalnya hanya diapptapi route ada dirouterterpisah.
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.bodyhasilnya{}: parser jalan, tapi isi tidak terbaca. Curigai Content-Type atau JSON tidak valid.req.bodyhasilnyaundefined: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
- Pasang
app.use(express.json())paling atas, sebelum route. - Pastikan pengirim memakai
Content-Type: application/json. - Uji dengan curl atau Postman memakai raw JSON.
- Validasi
req.bodysebelum 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.