Node.js/Express线上req.body为undefined但本地运行正常如何解决

最常见根因：请求重定向丢失body #

• 检查你请求线上接口的地址是否和服务端监听的协议（HTTP/HTTPS）、域名完全匹配，多数站点会配置HTTP强制跳HTTPS，301/302重定向默认会将POST请求转为GET请求，同时丢弃请求body，导致req.body为空
• 排查方法：直接请求HTTPS前缀的线上接口地址测试，或者查看浏览器/接口请求工具的Network日志，确认是否存在301/302跳转记录

检查请求头配置 #

• 确保POST请求的Content-Type请求头为application/json，如果你的请求头是multipart/form-data（表单文件上传格式）或者text/plain，Express默认的express.json()和express.urlencoded()中间件不会解析对应格式的body
• 如果需要支持multipart/form-data格式的请求，需要引入multer中间件做解析

检查反向代理/服务部署配置 #

• 如果你线上用Nginx、Apache等反向代理托管服务，确认代理配置允许转发POST请求的完整body，没有额外的body截断、请求头修改规则
• 确认线上部署的代码和本地完全一致，避免PM2等进程管理工具没有重启加载最新代码，可执行pm2 reload all（如果使用PM2部署）重启服务后重试

临时调试验证方法 #

在你的路由代码中添加日志输出，确认线上实际收到的请求内容：

router.post("/send", (req, res) => {
  // 打印日志排查实际收到的内容
  console.log('收到请求body：', req.body);
  console.log('请求Content-Type：', req.get('Content-Type'));
  res.send(`message is ${req.body.message}`);
});

部署后查看服务端日志，即可快速定位是body未解析、还是请求本身没有携带对应参数。

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