Express中API无法接收Handlebars表单提交的数据问题

你已经确认API被触发，但拿不到表单数据对吧？我来帮你梳理几个最容易踩坑的排查方向：

1. 先检查表单输入框的name属性是否匹配 #

Handlebars渲染的表单里，输入框的name必须和后端要获取的字段完全一致——也就是username和password。举个正确的表单示例：

<form action="/register" method="POST">
  <input type="text" name="username" placeholder="请输入用户名">
  <input type="password" name="password" placeholder="请输入密码">
  <button type="submit">注册</button>
</form>

要是你把name写成了userName、user或者pass这类变体，后端_.get(req.body, 'username')肯定拿不到对应的值。

2. 确认后端配置了请求体解析中间件 #

如果用的是Express框架，默认不会自动解析普通表单提交的application/x-www-form-urlencoded格式数据。你需要在项目的入口文件（比如app.js）里添加这段中间件：

// Express 4.16+ 自带该功能，无需额外安装body-parser
app.use(express.urlencoded({ extended: true }));

没有这个中间件的话，req.body会是空对象或者undefined，自然拿不到表单字段。

3. 检查表单的提交方式和编码类型 #

• 表单的method必须是POST：你是从req.body里取数据，如果用GET提交，参数会跑到req.query里，根本不在req.body里。
• 不要乱设enctype：如果没有上传文件需求，就用表单默认的application/x-www-form-urlencoded就行。要是设了multipart/form-data，后端还得额外用multer这类工具解析，否则也拿不到数据。

4. 加个调试日志确认数据是否到达后端 #

在你的register函数开头加一行打印代码，看看req.body的真实内容：

exports.register = function (req, res, next) {
  console.log('实际收到的请求体:', req.body); // 打印出来看看到底拿到了什么
  var username = _.get(req.body, 'username');
  var password = _.get(req.body, 'password');
  // 后续校验逻辑...
}

如果打印出来是空对象，那就是中间件或者表单配置的问题；如果有数据但字段名不对，那就是表单name属性写错了。

按这个顺序排查，应该能快速定位问题~

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