Node.js+Express POST请求500错误：req.body未定义问题

你的报错TypeError: Cannot destructure property 'firstName' of 'req.body' as it is undefined，核心原因是Express没有配置请求体解析中间件，导致无法读取POST请求携带的参数，进而解构req.body时触发错误。

解决方案步骤： #

1. 添加请求体解析中间件
   Express默认不会自动解析请求体，需要手动挂载对应的中间件。根据你前端发送的数据格式，选择以下两种：

   • 若前端发送JSON格式数据，添加express.json()：
   • 若前端是表单提交（application/x-www-form-urlencoded格式），添加express.urlencoded({ extended: true })

   在你的server.js中，路由挂载前添加这些中间件：

   const express = require('express');
   const app = express();
   const apiRouter = require('./path/to/your/apiRouter'); // 替换为你的路由文件路径
   
   // 解析JSON格式请求体
   app.use(express.json());
   // 解析表单格式请求体（按需添加）
   app.use(express.urlencoded({ extended: true }));
   
   // 挂载你的API路由
   app.use('/api', apiRouter); // 这里的前缀要和你请求的URL对应
   

2. 验证前端请求的Content-Type

   • 用Thunderclient测试时，若选择JSON格式的请求体，确保请求头包含Content-Type: application/json
   • 若使用表单提交，Content-Type需设置为application/x-www-form-urlencoded
     不匹配的Content-Type会导致中间件无法正确解析请求体。

3. 排查请求体字段完整性
   在路由中临时添加日志，确认请求体内容：

   apiRouter.post('/create-timecard', (req, res) => {   
       console.log('Received request body:', req.body); // 检查是否有预期的字段
       const { firstName, lastName, employeeId } = req.body;
       // 后续代码...
   });
   

   若日志显示req.body仍为空，需确认前端是否正确发送了这三个字段。

修正后的路由代码示例 #

确保中间件配置完成后，你的原有路由逻辑即可正常工作：

apiRouter.post('/create-timecard', (req, res) => {   
    const { firstName, lastName, employeeId } = req.body;
    const today = new Date().toISOString().split('T')[0];
    const timeCardFileName = `${today}_${employeeId}.txt`;

    fs.writeFile(`./TimeCard/database/${timeCardFileName}`, '', (err) => {
        if (err) {
            console.error('Error creating time card:', err);
            res.status(500).send('Error creating time card');
            return;
        }
        res.send({ message: 'Time card created successfully', timeCardFileName });
    });
});

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