SendGrid报错：Can't set headers after they are sent及多邮件发送问题解决

咱们先拆解你遇到的两个核心问题，一步步来解决：

1. 为什么会触发Can't set headers after they are sent错误？ #

你代码里的res.sendStatus(httpStatus.OK)已经完成了整个响应的发送流程——这个方法会自动设置状态码，同时把对应的状态文本（比如200对应的"OK"）作为响应体发送出去。之后你再调用.json({ success: true })，相当于试图在请求-响应周期已经结束后，再次修改响应头和响应体，这就触发了Node.js/Express的经典错误。

简单说：sendStatus()直接结束了请求，不能在它之后再调用任何修改响应的方法。

2. 单封邮件场景的修复代码 #

把sendStatus()换成res.status()，它只是设置响应状态码，不会立刻发送响应，之后你可以正常调用.json()返回自定义响应内容：

import * as httpStatus from 'http-status';
import config from '../config/config';
const sgMail = require('@sendgrid/mail');

function sendemail(req, res) {
 sgMail.setApiKey(config.sendgridKey);
 const msg = {
  to: req.body.to,
  from: req.body.from,
  subject: req.body.subject,
  text: req.body.content,
  html: '<strong>' + req.body.content + '</strong>',
 };

 sgMail.send(msg)
  .then(result => {
    // 先用status设置状态码，再用json返回响应体
    return res.status(httpStatus.OK).json({ success: true });
  })
  .catch(err => {
    // 同样的方式处理错误场景
    return res.status(httpStatus.INTERNAL_SERVER_ERROR).json({ success: false, error: err.message });
  });
}

export default { sendemail };

3. 支持多封邮件的最佳方案 #

如果要一次性发送多封邮件，绝对不能在单封邮件的回调里就返回响应（那样会提前结束请求，后续未完成的邮件Promise拒绝会触发未处理警告）。推荐用Promise.all()并行处理所有邮件请求，等全部完成后统一返回响应：

import * as httpStatus from 'http-status';
import config from '../config/config';
const sgMail = require('@sendgrid/mail');

function sendMultipleEmails(req, res) {
 sgMail.setApiKey(config.sendgridKey);
 // 假设req.body.to是一个邮箱数组，每一项对应一封邮件的收件人
 const emailPromises = req.body.to.map(to => {
  const msg = {
   to: to,
   from: req.body.from,
   subject: req.body.subject,
   text: req.body.content,
   html: '<strong>' + req.body.content + '</strong>',
  };
  // 单个邮件Promise单独捕获错误，避免某一封失败导致整个请求中断
  return sgMail.send(msg)
   .then(() => ({ to, success: true }))
   .catch(err => ({ to, success: false, error: err.message }));
 });

 // 等待所有邮件处理完成
 Promise.all(emailPromises)
  .then(results => {
    // 统计成功/失败数量，返回详细结果给前端
    const successCount = results.filter(r => r.success).length;
    const failCount = results.length - successCount;
    res.status(httpStatus.OK).json({
      success: true,
      total: results.length,
      successCount,
      failCount,
      details: results
    });
  })
  .catch(err => {
    // 捕获Promise.all本身的异常（极少出现）
    res.status(httpStatus.INTERNAL_SERVER_ERROR).json({ success: false, error: err.message });
  });
}

export default { sendMultipleEmails };

核心注意点： #

• 用Promise.all()并行发送邮件，效率远高于串行发送
• 单个邮件的Promise单独捕获错误，确保某一封发送失败时，其他邮件仍能正常处理
• 最后统一返回所有邮件的处理状态，让前端能清晰知晓每封邮件的结果

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