Node.js注册用户后发邮件报错：Cannot set headers错误

问题根源 #

你的代码触发该错误的核心原因是同一个HTTP请求被多次发送响应：

• 在registerUser中，用户创建成功后先调用sendMail，随后立刻执行res.status(201).json(...)返回成功响应。
• 而sendMail内部如果邮件发送失败，会再次调用res.status(500).json(...)返回错误响应。
• 由于transporter.sendMail是异步操作，registerUser里的201响应会先发送给客户端，后续若邮件发送失败，sendMail里的500响应会试图在已发送响应后再次设置响应头，从而触发错误。

解决方案 #

核心思路：禁止工具函数直接操作响应对象res，统一由路由函数管理响应输出，具体实现步骤如下：

1. 重构sendMail为Promise风格

修改sendMail，让它返回Promise，不再直接处理res，将邮件发送的成功/失败状态交给调用方处理：

export function sendMail(req) {
  return new Promise((resolve, reject) => {
    const mailOptions = {
      from: 'neublua.game10@gmail.com',
      to: req.body.email,
      subject: 'Sending Email using Node.js',
      text: 'That was easy!',
    };

    transporter.sendMail(mailOptions, (error, info) => {
      if (error) {
        reject(error);
      } else {
        console.log('Email sent: ' + info.response);
        resolve(info);
      }
    });
  });
}

2. 修改registerUser统一处理响应

将registerUser改为异步函数，使用async/await处理用户创建和邮件发送的异步流程，确保一个请求只发送一次响应：

export async function registerUser(req, res, next) {
  console.log(JSON.stringify(req.body));

  const { name, email, password, phone, role, level } = req.body;

  try {
    // 创建用户
    const result = await userModel.create({
      name,
      email,
      password,
      createdAd: Date.now(),
      phone,
      photo: `${req.protocol}://${req.get('host')}/images/${req.file.filename}`,
      level: 1,
      role,
      status: 0,
    });

    try {
      // 发送邮件
      await sendMail(req);
      // 邮件发送成功，返回用户创建成功响应
      res.status(201).json({
        message: 'User added successfully!',
      });
    } catch (mailError) {
      // 邮件发送失败，但用户已创建成功，可根据业务需求选择响应方式
      // 方案1：优先保证用户创建成功，告知邮件发送失败（推荐）
      res.status(201).json({
        message: 'User added successfully, but failed to send verification email.',
        error: mailError.message
      });

      // 方案2：要求邮件必须发送成功才返回成功（可选）
      // res.status(500).json({
      //   message: 'User created but failed to send verification email.',
      //   error: mailError.message
      // });
    }
  } catch (err) {
    // 用户创建失败，交给错误中间件处理
    next(err);
  }
}

关键说明 #

• 移除工具函数对res的直接操作，从根源避免重复响应的风险。
• 用async/await简化异步流程，确保只有一个响应被发送给客户端。
• 邮件发送失败时，可根据业务需求选择响应策略：优先保证用户创建成功（更符合用户体验），或要求邮件发送成功才返回成功。

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