【初心者向け】Node.js、Express、Postmanで「req.body empty on posts」問題を解決する方法

2024-04-02

Node.js、Express、Postmanにおける「req.body empty on posts」問題の解決策

Node.js、Express、Postmanを使用してAPIを構築する際に、req.bodyが空になる問題が発生することがあります。これは、リクエストのボディが正しく解析されていないことが原因です。

原因

この問題にはいくつかの原因が考えられます。

Content-Typeヘッダーの設定

リクエストヘッダーにContent-Typeが設定されていない場合、Expressはリクエストボディを解析できません。Content-Typeヘッダーは、リクエストボディのデータ形式を指定するために使用されます。

ミドルウェアの使用

リクエストボディを解析する前に、bodyParserなどのミドルウェアを使用する必要があります。bodyParserは、リクエストボディを解析して、req.bodyオブジェクトに格納します。

Postmanの設定

Postmanを使用する場合は、リクエストボディのデータ形式を正しく設定する必要があります。Postmanでは、Bodyタブでデータ形式を選択できます。

解決策

以下の方法で問題を解決することができます。

リクエストヘッダーにContent-Typeヘッダーを設定します。Content-Typeヘッダーの値は、リクエストボディのデータ形式に応じて設定します。

Content-Type: application/json

const express = require('express');
const bodyParser = require('body-parser');

const app = express();

app.use(bodyParser.json());

app.post('/api/users', (req, res) => {
  const user = req.body;
  // ...
});

Postmanを使用する場合は、Bodyタブでデータ形式を正しく設定します。

JSON形式の場合

BodyタブでContent-Typeをapplication/jsonに設定し、リクエストボディを入力します。

フォームデータ形式の場合

補足

上記以外にも、問題の原因は考えられます。問題解決のために、以下の点を試してみてください。

サーバコンソールやネットワークログを確認して、エラーメッセージがないか確認します。
使用しているライブラリのバージョンを確認して、最新バージョンであることを確認します。

app.js

const express = require('express');
const bodyParser = require('body-parser');

const app = express();

app.use(bodyParser.json());

app.post('/api/users', (req, res) => {
  const user = req.body;

  // データベースにユーザー情報を保存する処理

  res.send(201, user);
});

app.listen(3000);

Postmanで以下の設定を行います。

URL: http://localhost:3000/api/users
Method: POST
Headers:

Body:

{
  "name": "John Doe",
  "email": "[email protected]"
}

実行

app.jsを実行します。
Postmanで設定したリクエストを送信します。
サーバコンソールを確認すると、リクエストボディの内容が出力されます。

上記のサンプルコードは、基本的な例です。実際の開発では、データベースへの接続やエラー処理など、より多くの処理が必要になります。

req.body empty on posts 問題を解決する他の方法

raw-bodyミドルウェアを使うと、リクエストボディを生のバッファとして取得することができます。

const express = require('express');
const rawBody = require('raw-body');

const app = express();

app.use(rawBody());

app.post('/api/users', (req, res) => {
  const body = req.rawBody;

  // ...

  res.send(201, body);
});

app.listen(3000);

const express = require('express');
const qs = require('qs');

const app = express();

app.use(qs());

app.post('/api/users', (req, res) => {
  const user = req.body;

  // ...

  res.send(201, user);
});

app.listen(3000);