如何在Node.js Express中获取请求body的form表单数据

• 检查body解析中间件的注册顺序
  express.urlencoded、express.json这类全局body解析中间件必须注册在所有路由定义之前，顺序颠倒时，请求到达路由时还未经过解析处理，无法读取req.body属性。
  错误配置示例：

// 错误：先注册路由再注册解析中间件
app.post('/hide_feed', middleware.authenticateToken, (req, res) => {
  // 逻辑代码
})
app.use(express.urlencoded({ extended: true }))

正确配置示例：

// 正确：先注册解析中间件再注册路由
app.use(express.urlencoded({ extended: true }))
app.post('/hide_feed', middleware.authenticateToken, (req, res) => {
  // 逻辑代码
})

• 匹配表单类型与解析中间件
  express.urlencoded仅支持解析Content-Type: application/x-www-form-urlencoded格式的表单数据。如果Postman中选择的是form-data格式（多用于文件上传场景），需要使用multer中间件解析：

1. 安装依赖：npm install multer
2. 路由配置：

const multer = require('multer')
// 无文件上传的form-data场景使用.none()方法
const upload = multer().none()
app.post('/hide_feed', middleware.authenticateToken, upload, (req, res) => {
  // 此时可正常读取req.body内的参数
  if (req.body.followered_to_id) {
    return res.status(400).json({
      status: 400,
      msg: req.body.followered_to_id
    });
  }
})

• 检查认证中间件是否消耗请求流
  如果middleware.authenticateToken中间件内存在手动读取req请求流的操作（比如签名校验时读取body内容），会导致后续解析中间件无法读取已经被消费的请求流，需要确认该中间件未提前消费请求，或在该中间件内完成body解析后再向下传递。
• 新增调试路由定位问题
  在所有中间件、路由注册的最前方添加测试路由，验证解析功能是否正常：

app.post('/test', express.urlencoded({extended: true}), (req, res) => {
  res.json({
    contentType: req.get('Content-Type'),
    body: req.body
  })
})

用Postman请求该测试接口，若能正常返回body参数，说明问题出在原有路由的中间件顺序或类型匹配上；若仍无法获取参数，检查Node.js、Express版本是否存在兼容问题。

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