如何通过Node.js+Express向MySQL表插入数据？表单插值为Null问题

嘿，这个问题我简直太熟悉了！之前用Express+MySQL做表单提交的时候，也踩过同样的「插入Null」大坑，咱们一步步来揪出问题所在：

1. 先确认表单字段名和服务端变量完全匹配 #

这是最常见的原因！比如你的EJS表单里输入框的name属性是user_name，但服务端你写成了req.body.username，那这个变量就会是undefined，插入数据库自然变成Null。

解决办法：

• 先直接打印console.log(req.body)，而不是单个变量，看看返回的对象里所有字段是不是都正确获取到了。如果req.body里没有你要的字段，那肯定是表单name写错了。
• 用解构赋值的时候，确保变量名和表单name完全一致，比如：

  // 表单name是"full_name"，这里就要写full_name
  const { full_name, user_email } = req.body;
  

2. 检查SQL插入语句的参数对应关系 #

很多人会在拼接SQL的时候出错，或者参数顺序搞反了，导致插入的值不对。强烈建议用参数化查询，既安全又不容易出错。

错误示例（容易踩坑）：

// 假设SQL字段顺序是name, email，但参数顺序反了
const sql = "INSERT INTO users (name, email) VALUES (?, ?)";
db.query(sql, [user_email, full_name], (err, res) => { ... })

正确示例：

const { full_name, user_email } = req.body;
const sql = "INSERT INTO users (name, email) VALUES (?, ?)";
// 参数顺序和SQL字段顺序完全对应
db.query(sql, [full_name, user_email], (err, result) => {
  if (err) {
    console.error('插入出错:', err);
    return res.status(500).send('插入失败');
  }
  res.send('插入成功！');
});

如果用命名占位符（mysql2支持），要确保对象的键和占位符一致：

const sql = "INSERT INTO users (name, email) VALUES (:name, :email)";
db.query(sql, { name: full_name, email: user_email }, (err, result) => { ... })

3. 别忘了配置Express的body解析中间件 #

Express 4.16.0之后虽然自带了body解析，但如果你没配置的话，req.body会是空对象，所有变量都是undefined，插入数据库就是Null。

一定要在路由之前加上这两行：

app.use(express.urlencoded({ extended: true }));
// 如果有JSON格式的提交，还要加这个
app.use(express.json());

最后快速排查步骤 #

1. 刷新页面重新提交表单，看console.log(req.body)的输出是否包含所有表单字段和正确的值；
2. 核对每个变量和表单name的拼写，大小写也要注意（比如UserName和username是两个不同的键）；
3. 检查SQL语句的参数顺序/命名是否和变量完全对应；
4. 确认body解析中间件已经正确配置。

按照这个步骤走，90%的概率能解决问题！

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