Node.js+Express从HTML表单取输入存MongoDB报错解决

这个错误的核心是req.body未定义，导致读取uname属性失败。手动赋值能正常运行，说明数据库连接、模型定义和路由逻辑本身没问题，问题出在表单数据解析环节或者表单提交配置上。

1. 给Express配置表单数据解析中间件 #

Express默认不会自动解析POST请求的表单数据，必须手动添加中间件：

• 如果是普通表单（application/x-www-form-urlencoded格式），在app.js的路由挂载前添加：

app.use(express.urlencoded({ extended: true }));

• 要是表单带文件上传（multipart/form-data格式），得用multer这类中间件，但你这个场景用第一种就行。

2. 检查form.ejs里的表单配置 #

表单必须满足这几个要求：

• method属性设为POST，GET请求的数据不会存到req.body里
• 输入字段的name属性要和后端读取的字段名完全一致：也就是uname和umail
• 正确示例：

<form action="/你的路由地址" method="POST">
  <input type="text" name="uname" placeholder="用户名" required>
  <input type="email" name="umail" placeholder="邮箱" required>
  <button type="submit">提交</button>
</form>

注意：后端是通过name属性取值，别写成id或者其他属性。

3. 核对controller.js的变量名一致性 #

确保从req.body里读取的字段和表单name完全匹配：

// controller.js正确写法示例
const User = require('./model');

exports.createUser = async (req, res) => {
  try {
    const newUser = new User({
      uname: req.body.uname,
      umail: req.body.umail
    });
    await newUser.save();
    res.status(201).send('用户创建成功');
  } catch (err) {
    res.status(500).send(err.message);
  }
};

要是表单里的name是username而不是uname，肯定读不到数据，必须严格对应。

4. 检查route.js的路由配置 #

确保路由用的是POST方法，且路径和表单action一致：

// route.js示例
const express = require('express');
const router = express.Router();
const userController = require('./controller');

router.post('/register', userController.createUser);

module.exports = router;

5. 确认app.js的中间件顺序 #

解析中间件必须在路由挂载之前，顺序不能乱：

// app.js正确顺序示例
const express = require('express');
const app = express();
const userRoutes = require('./route');

// 先配置解析中间件
app.use(express.urlencoded({ extended: true }));
// 再挂载路由
app.use('/', userRoutes);

app.listen(3000, () => console.log('服务器运行在3000端口'));

要是以上配置都没问题还报错，按下面步骤查：

• 在控制器方法开头加console.log(req.body)，看能不能打印出表单数据，要是打印undefined，说明中间件没生效或者表单提交方式不对。
• 核对表单action路径和路由路径完全匹配，比如路由是/register，表单action不能多写斜杠变成/register/。
• 确认没有其他中间件拦截POST请求，比如错误的CORS或权限验证中间件导致请求没到控制器。

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