使用Nodemailer在Netlify Lambda函数中发送邮件附件出现超时错误

问题根因 #

你遇到的超时本质是Nodemailer处理URL类型附件的默认逻辑问题：直接给attachment配置项传远程URL时，Nodemailer会在进程内同步发起HTTP请求拉取资源，再编码后带入邮件发送流程，「拉取附件+发送邮件」两个串行网络请求叠加Netlify Lambda的冷启动开销，很容易触达10秒的阈值。而你嵌入图片到正文时没有额外的远程资源拉取步骤，直接传入了本地资源或者base64编码内容，所以不会超时。

修复方案 #

• 预拉取资源并配置超时限制
  不要让Nodemailer自行处理远程资源拉取，你可以提前用node-fetch主动拉取图片，设置拉取超时不超过3秒，拉取成功后直接将buffer传给Nodemailer的附件配置，避免Nodemailer内部的无超时请求拖慢流程。
  示例代码：

const fetch = require('node-fetch');
// 预拉取附件资源
const imgRes = await fetch('目标图片URL', { timeout: 3000 });
const imgBuffer = await imgRes.buffer();

// Nodemailer附件配置
const attachments = [{
  filename: 'image.jpg',
  content: imgBuffer
}]

• 调整Nodemailer传输配置的超时时间
  给Nodemailer的transport配置明确的连接超时和发送超时，总耗时控制在7秒以内，留3秒冗余给Netlify的冷启动和执行开销：

const transporter = nodemailer.createTransport({
  host: '你的SMTP主机地址',
  port: 465,
  secure: true,
  auth: {
    user: 'SMTP账号',
    pass: 'SMTP密码'
  },
  // 新增超时配置
  connectionTimeout: 2000, // 连接超时2秒
  greetingTimeout: 2000, // 握手超时2秒
  socketTimeout: 3000 // 内容传输超时3秒
})

• 优化Netlify Lambda配置
  可以在netlify.toml中主动将函数超时设置为最大允许的10秒，避免默认短超时限制：

[functions]
  timeout = 10

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