生产环境中Nodemailer邮件延迟或丢失问题排查

一、代码层面的潜在问题 #

1. 语法错误：userMailOptions中subject字段末尾缺少逗号，会导致代码运行报错，需修正：

const userMailOptions = {
    from: appTitle,
    to: userEmail,
    subject: `${appTitle} - User Confirmation`, // 补上缺失的逗号
    text: 'User Confirmation'
}

2. 发件人格式不规范：from字段仅使用appTitle作为名称，未包含真实发件邮箱地址。Gmail SMTP要求发件人需验证，且外部邮件服务器会严格校验发件人真实性，建议改为带邮箱的规范格式：

from: `${appTitle} <${gmailUser}>`,

仅用名称会让外部服务器判定发件人伪造，将邮件归入垃圾队列或直接拒收。

3. Promise异常未捕获：调用emailConfirmation(user.email)时未处理返回的Promise异常，无法及时感知发送失败情况，建议补充处理逻辑：

emailConfirmation(user.email)
  .then(success => {
    if (!success) {
      // 处理发送失败的业务逻辑
    }
  })
  .catch(err => {
    // 捕获并处理异常
  });

二、域名与邮件投递层面的问题（核心嫌疑） #

1. SPF/DKIM/DMARC记录缺失：外部收件服务器会校验邮件身份合法性，若你的域名未配置这些记录，邮件极易被标记为垃圾或延迟：

   • SPF：在域名DNS中添加包含Google SMTP服务器的记录，示例：v=spf1 include:_spf.google.com ~all
   • DKIM：若使用自定义域名作为发件人，需在Google侧启用DKIM并配置对应DNS记录
   • DMARC：添加DMARC记录指导收件服务器处理未通过校验的邮件，示例：v=DMARC1; p=quarantine; sp=quarantine; rua=mailto:dmarc@yourdomain.com

2. 生产环境IP或发送频率限制：生产服务器IP可能被垃圾邮件黑名单收录，或发送频率触发Gmail的限额，导致邮件被Google队列延迟发送。可检查Gmail账号发送配额，或改用Google Workspace账号获取更高发送限额。

3. 同域信任差异：管理员邮箱与网站同域名，收件服务器对同域邮件校验标准更低，因此能正常接收；而外部收件服务器严格校验，导致邮件延迟或丢失。

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