How to Fix Empty req.body in Express: Simple Solution

The req.body is empty in Express because the body-parsing middleware is missing or not used. To fix this, add express.json() or express.urlencoded() middleware before your routes to parse incoming JSON or form data.

Why This Happens

Express does not parse the request body by default. Without middleware to read and convert the incoming data, req.body remains empty. This often happens when developers forget to add body-parsing middleware or add it after defining routes.

javascript

import express from 'express';
const app = express();

app.post('/submit', (req, res) => {
  console.log(req.body); // Outputs: undefined or {}
  res.send('Received');
});

app.listen(3000);

Output

{}

The Fix

Add the built-in express.json() middleware before your routes to parse JSON request bodies. For form data, use express.urlencoded({ extended: true }). This middleware reads the incoming data and fills req.body correctly.

javascript

import express from 'express';
const app = express();

// Middleware to parse JSON bodies
app.use(express.json());

app.post('/submit', (req, res) => {
  console.log(req.body); // Outputs the parsed JSON object
  res.send('Received');
});

app.listen(3000);

Output

{"name":"Alice","age":30}

Prevention

Always add body-parsing middleware early in your Express app setup, before defining routes that need to access req.body. Use express.json() for JSON and express.urlencoded() for URL-encoded form data. Keep your dependencies updated and test your endpoints with tools like Postman or curl.

Related Errors

Other common issues include undefined req.body due to incorrect Content-Type headers, or syntax errors in JSON payloads causing parsing to fail. Always ensure the client sends the correct Content-Type header like application/json when sending JSON data.

Key Takeaways

Add express.json() middleware before routes to parse JSON request bodies.

Use express.urlencoded({ extended: true }) for form data parsing.

Without body-parsing middleware, req.body will be empty or undefined.

Ensure clients send the correct Content-Type header matching the body format.

Test your API endpoints with tools like Postman to verify request bodies.