React应用结合Heroku部署的NodeJS后端使用Nodemailer发送邮件成功却返回503状态码的问题排查求助

你的代码里藏着一个极易忽略的细节问题——邮件发送成功后，你并没有向客户端返回任何实际的HTTP响应，只是返回了res对象本身。这会导致请求一直处于挂起状态，直到触发Heroku的请求超时阈值，最终返回503错误。

具体问题分析 #

看你这段核心代码：

try {
  await transporter.sendMail({/* ... */});
  console.log("Objednávka bola úspešne odoslaná");
  return res; // 这里只是返回res对象，没有主动结束请求！
} catch (error) {
  console.log("error: ", error);
  return error; // 这里也没有给客户端返回错误响应
}

邮件发送成功后，Node.js服务器并没有向客户端发送任何结束请求的信号（比如200状态码的响应）。Heroku会判定你的服务无法及时处理请求，等待超时后就会返回503（服务不可用）。

修复方案 #

你需要在try和catch块中，调用Express响应对象的方法来主动结束请求：

1. 成功时返回200响应 #

邮件发送成功后，用res.status(200).json()或res.send()返回成功信息：

try {
  await transporter.sendMail({/* ... */});
  console.log("Objednávka bola úspešne odoslaná");
  return res.status(200).json({ 
    success: true,
    message: "邮件已成功发送" 
  });
}

2. 失败时返回错误响应 #

在catch块里，也要向客户端返回错误状态码（比如500）和错误信息，而非直接返回error对象：

catch (error) {
  console.log("error: ", error);
  return res.status(500).json({ 
    success: false,
    message: "邮件发送失败",
    error: error.message 
  });
}

额外验证建议 #

• 可以通过Heroku CLI查看实时日志，确认超时问题：运行heroku logs --tail，然后触发请求，就能看到请求超时的具体日志记录。
• 虽然邮件能正常发送，还是要确认Heroku上的环境变量（MAIL_HOST、MAIL_PORT等）配置完全正确，避免潜在的隐性问题。

按照这个修改后，接口会在邮件处理完成后立即返回响应，不会再触发Heroku的超时503错误了。

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