Node.js表单数据解析异常：req.body未定义致JSON存null

核心原因是Express框架默认不会自动解析application/x-www-form-urlencoded格式的表单请求体，必须手动配置对应的中间件才能获取到req.body的数据。以下是具体解决步骤：

1. 配置表单解析中间件 #

针对Express v4.16.0+（推荐） #

Express从v4.16.0开始内置了express.urlencoded中间件，无需额外安装依赖，直接在代码中添加：

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

// 解析表单数据，extended: true支持解析复杂嵌套的表单结构
app.use(express.urlencoded({ extended: true }));

// 处理/recommend接口的POST请求
app.post('/recommend', (req, res) => {
  // 现在可以正常获取表单数据
  console.log(req.body);
  // 写入JSON文件的逻辑示例
  const fs = require('fs');
  fs.writeFile('target.json', JSON.stringify(req.body), (err) => {
    if (err) {
      console.error(err);
      return res.status(500).send('保存失败');
    }
    res.send('数据提交成功');
  });
});

app.listen(3000, () => console.log('服务运行在http://localhost:3000'));

针对旧版Express（v4.16.0之前） #

需要先安装body-parser依赖：

npm install body-parser

然后在代码中配置：

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

app.use(bodyParser.urlencoded({ extended: true }));

// 后续路由逻辑同上

2. 检查HTML表单配置 #

确保表单的method、action和enctype属性正确：

<form method="POST" action="/recommend" enctype="application/x-www-form-urlencoded">
  <input type="text" name="name1" placeholder="输入内容">
  <!-- 其他表单字段 -->
  <button type="submit">提交</button>
</form>

• method必须为POST
• action要和后端接口路径/recommend一致
• enctype默认就是application/x-www-form-urlencoded，可以省略，但如果手动设置了其他值（比如multipart/form-data），需要用对应中间件处理（如multer）

3. 常见排查要点 #

• 中间件必须放在路由定义之前，否则路由处理时请求体还未被解析
• 表单输入框的name属性要和后端获取的字段名一致（比如要取req.body.name1，输入框的name必须是name1）
• 如果是上传文件的表单，不能用urlencoded中间件，需要使用multer处理multipart/form-data类型的请求体

内容的提问来源于stack exchange，提问作者Taif