Node.js Express处理HTML表单POST时req.body为undefined求助

Express 4.x 版本之后，不再默认自动挂载请求体解析中间件。你当前的服务代码没有配置对应的解析规则，框架无法从POST请求的报文中提取表单内容并挂载到req.body属性上，因此控制台打印req.body结果为undefined。

• 在初始化Express实例之后、定义所有路由之前，补挂对应格式的请求体解析中间件。因为你的前端是原生HTML表单提交，默认的报文编码格式为application/x-www-form-urlencoded，需要匹配Express内置的urlencoded解析能力。
• 必须保证中间件的挂载顺序在路由定义之前，否则请求走到路由处理逻辑时还没执行解析流程，req.body依然无法被正确赋值。

修改后的完整服务端代码如下：

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

// 新增配置：解析原生表单提交的urlencoded格式请求体
// extended:false 表示使用系统内置querystring模块解析普通键值对，足够满足常规表单需求
app.use(express.urlencoded({ extended: false }))
// 后续如果需要接收前端JSON格式的请求，可补充启用json解析
// app.use(express.json())

app.get('/', function (req, res) {
   res.sendFile(path.join(__dirname,'index.html'))
})

app.post('/submit',(req, res) => {
 console.log(req.body)
 // 路由处理逻辑里需要返回响应，否则请求会一直处于挂起状态
 res.send('提交成功')
})

app.listen(3000,function(){
  console.log("server started")
})

• 原生HTML表单如果没有手动设置enctype属性，默认就会以application/x-www-form-urlencoded格式提交数据，和上面配置的解析逻辑完全匹配，不需要修改前端表单的现有代码。
• 你前端表单中“Licence No”对应的输入项，name属性值带有空格，解析后会在req.body中生成带空格的键名（即req.body['Licence No']），虽然功能上不影响提交，但建议把带空格的name值改成短横线或驼峰格式，避免后续取值时出现兼容问题。
• 不需要额外安装已经废弃的body-parser第三方包，Express本身已经内置了对应解析能力的封装，直接调用内置方法即可满足绝大多数场景的需求。

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