Node.js邮件调度请求超时：如何规避30秒超时错误？

问题背景 #

我正在开发一个邮件调度器，代码如下：

router.post(`/blogs`, async (req, res) => {
  let mailTransporter = nodemailer.createTransport({
    service: "gmail",
    auth: {
      user: process.env.GOOGLE_APP_EMAIL,
      pass: process.env.GOOGLE_APP_PW
    }
  });
  const data = {
    to: `${req.body.to}`,
    second: `${req.body.second}`,
    minute: `${req.body.minute}`,
  };
  const task = cronJob.schedule(`*/${data.minute}`, () => {
    mailTransporter.sendMail(data, err => {
    });
  })
    task.stop();

});

当设置的调度时间超过30秒时，部署服务器日志出现错误：

"Process timed out after 30 seconds"

请求响应无法正常到达后端，想知道是否可以设置加载机制维持服务器运行避免超时，或者有其他解决办法？

解决方案 #

1. 立即返回HTTP响应

当前代码核心问题是未给客户端返回任何响应，导致请求长期挂起触发服务器30秒超时限制。无论调度任务创建结果如何，都要第一时间给客户端返回状态：

router.post(`/blogs`, async (req, res) => {
  try {
    const mailTransporter = nodemailer.createTransport({
      service: "gmail",
      auth: {
        user: process.env.GOOGLE_APP_EMAIL,
        pass: process.env.GOOGLE_APP_PW
      }
    });
    // 补充nodemailer必填字段，否则邮件无法发送
    const data = {
      to: req.body.to,
      subject: "定时邮件通知",
      text: "这是你设置的定时发送邮件内容",
      scheduleSecond: req.body.second,
      scheduleMinute: req.body.minute
    };
    
    // 修正cron表达式，同时使用秒和分钟参数
    const task = cronJob.schedule(`${data.scheduleSecond} */${data.scheduleMinute} * * * *`, () => {
      mailTransporter.sendMail(data, (err, info) => {
        if (err) {
          console.error("邮件发送失败:", err);
        } else {
          console.log("邮件发送成功:", info.response);
        }
      });
    });

    // 不要立刻停止任务，否则调度不会执行
    // task.stop();

    // 立即返回响应，结束请求
    res.status(200).json({
      success: true,
      message: "邮件调度任务已创建",
      scheduleRule: `${data.scheduleSecond} */${data.scheduleMinute} * * * *`
    });
  } catch (err) {
    res.status(500).json({
      success: false,
      message: "创建调度任务失败",
      error: err.message
    });
  }
});

2. 适配部署环境限制

如果你的部署环境是Vercel、Netlify、AWS Lambda这类无服务器函数，它们本身存在请求超时限制（通常30秒），且函数执行结束后会被冻结，无法长期运行定时任务。这种情况要换思路：

• 不要在请求处理函数内直接创建cron任务，而是把调度规则存储到数据库（如MongoDB、Redis）
• 使用专门的定时任务服务（如Cloud Scheduler）或队列服务（如BullMQ）来触发邮件发送
• 改用长运行服务器（如EC2、DigitalOcean Droplet）部署，这类服务器无请求超时限制，可正常运行cron任务

3. 修复代码其他问题

• 原cron表达式未使用秒参数，需调整格式实现精准调度
• nodemailer.sendMail的参数缺少subject、text等必填字段，会导致邮件发送失败
• 原代码创建任务后立刻调用task.stop()，直接终止了调度逻辑，需删除该语句

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