Express+Nodemailer表单邮件发送问题排查：变量未定义与body-parser异常

body-parser 核心问题分析 #

你遇到的req.body返回undefined、ReferenceError以及请求错误，核心原因集中在以下几点：

1. 中间件加载顺序错误：body-parser必须在所有路由定义之前加载，否则路由处理请求时，请求体还未被解析。
2. 未匹配请求内容类型：如果客户端发送JSON格式数据，未配置bodyParser.json()；如果是表单urlencoded格式，未配置bodyParser.urlencoded({ extended: true })，都会导致req.body为空。
3. 变量引用错误：ReferenceError: firstnameprop未定义是因为直接使用了未声明的变量，正确的做法是从req.body中提取字段（比如req.body.firstname），而非直接使用未绑定的变量名。
4. Nodemailer触发时机错误：重启服务器时发送测试邮件，说明你把sendMail逻辑写在了路由外部（服务器启动时执行），此时没有请求上下文，自然无法获取表单数据。

排查步骤 #

• 检查中间件顺序：确认app.use(bodyParser...)语句在所有app.post/app.get路由定义之前。
• 打印请求上下文：在路由回调中添加console.log(req.headers, req.body)，查看请求头的Content-Type是否正确，以及请求体是否被解析。
• 隔离客户端问题：用Postman直接发送POST请求，设置正确的Content-Type（如application/json或application/x-www-form-urlencoded）和参数，验证服务器是否能正常接收数据。
• 校验变量作用域：确保所有表单字段变量都是从req.body中解构或获取，避免直接使用未声明的变量。
• 确认路由路径匹配：404错误大概率是客户端请求路径与服务器路由路径不一致，比如客户端请求/api/subscribe，但服务器定义的是/subscribe。

遗漏的配置与修正示例 #

必要配置补充 #

• 同时启用JSON和表单解析器，覆盖不同请求类型：

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

• 确保Axios请求配置正确：设置method: 'post'，data为表单对象，且请求头Content-Type与发送的数据格式匹配（比如发送JSON时设置'Content-Type': 'application/json'）。

修正后的核心代码示例 #

const express = require('express');
const bodyParser = require('body-parser');
const nodemailer = require('nodemailer');

const app = express();

// 先加载body-parser，必须在路由之前
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

// 初始化Nodemailer transporter（仅启动时执行一次）
const transporter = nodemailer.createTransport({
  host: '你的SMTP主机',
  port: 587,
  secure: false,
  auth: {
    user: '你的邮箱账号',
    pass: '你的邮箱授权码'
  }
});

// 正确的路由处理：仅在请求触发时执行邮件发送逻辑
app.post('/subscribe', (req, res) => {
  // 从req.body中提取表单数据，确保变量已声明
  const { firstname, email } = req.body;

  // 校验必填字段
  if (!firstname || !email) {
    return res.status(400).send('缺少姓名或邮箱字段');
  }

  const mailOptions = {
    from: '你的发送邮箱',
    to: '订阅接收邮箱@example.com',
    subject: '新用户订阅',
    text: `姓名：${firstname}\n邮箱：${email}`
  };

  transporter.sendMail(mailOptions, (err, info) => {
    if (err) {
      console.error('邮件发送失败:', err);
      return res.status(500).send('订阅失败，请稍后重试');
    }
    console.log('邮件发送成功:', info.response);
    res.status(200).send('订阅成功');
  });
});

app.listen(3000, () => {
  console.log('服务器运行在http://localhost:3000');
});

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