基于Nodemailer的SMTP邮件服务：失败重试与退信入库求助

我来帮你搞定这个邮件发送的重试和失败记录需求！结合你用Gmail SMTP的场景，我整理了完整的解决方案，一步步来：

第一步：先搞定Gmail SMTP的正确配置 #

Gmail现在对SMTP登录有严格限制，普通账号密码直接用会失败，你得先做这两步：

• 给你的Google账号开启两步验证
• 在Google账号设置里创建一个应用专用密码（这个密码用来代替你的原账号密码填到Nodemailer的auth里）

然后修正你的SMTP transport配置，Gmail推荐用465端口+SSL，或者587端口+STARTTLS，这里给你正确的配置：

const nodemailer = require("nodemailer");

// 正确的Gmail SMTP配置
const smtpConfig = nodemailer.createTransport({
  host: "smtp.gmail.com",
  port: 465, // 或者用587，此时secure要设为false，还要加requireTLS: true
  secure: true,
  auth: {
    user: "你的Gmail邮箱地址",
    pass: "你创建的应用专用密码"
  },
  logger: true, // 开启日志方便调试
  debug: true
}, {
  headers: [],
  priority: "normal"
});

第二步：实现带重试的邮件发送与失败记录 #

我们封装一个异步函数，实现最多2次重试，失败后把退信信息存入数据库。这里假设你用的是MongoDB（如果是SQL，把存储部分改成对应的SQL语句就行）：

// 假设你已经连接了数据库，这里用一个示例模型
const FailedEmail = require("./models/FailedEmail"); // 你的失败邮件模型

// 带重试的邮件发送函数
async function sendMailWithRetry(mailOptions, maxRetries = 2) {
  let retryCount = 0;
  let lastError;

  while (retryCount <= maxRetries) {
    try {
      const response = await smtpConfig.sendMail(mailOptions);
      console.log(`邮件发送成功，Message ID: ${response.messageId}`);
      return true;
    } catch (error) {
      lastError = error;
      retryCount++;
      console.log(`第${retryCount}次发送失败，错误信息: ${error.message}`);

      // 如果是无法恢复的错误（比如收件人地址不存在），直接终止重试
      if (error.responseCode === 550) {
        console.log("收件人地址无效，不再重试");
        break;
      }

      // 重试前等待1秒（可选，避免频繁请求）
      await new Promise(resolve => setTimeout(resolve, 1000));
    }
  }

  // 重试用完后，记录失败信息到数据库
  if (lastError) {
    try {
      const failedEmail = new FailedEmail({
        from: mailOptions.from,
        to: mailOptions.to,
        subject: mailOptions.subject,
        errorMessage: lastError.message,
        errorCode: lastError.responseCode,
        retryAttempts: retryCount,
        timestamp: new Date()
      });
      await failedEmail.save();
      console.log("失败邮件信息已存入数据库");
    } catch (dbError) {
      console.error("存入数据库失败:", dbError);
    }
    return false;
  }
}

// 测试调用
const testMailOptions = {
  from: "你的Gmail邮箱地址",
  to: "不存在的邮箱@example.com", // 用这个测试失败场景
  subject: "测试重试与失败记录",
  html: "<p>这是一封测试邮件</p>",
  dsn: {
    id: "test-123",
    return: "HEADERS",
    notify: ["failure", "delay"],
    recipient: "你的Gmail邮箱地址" // 用来接收退信通知
  }
};

sendMailWithRetry(testMailOptions);

关键细节说明 #

• 重试逻辑：用while循环控制重试次数，最多2次，每次失败后等待1秒再重试（可根据需求调整）
• 错误判断：通过error.responseCode识别错误类型，比如550通常表示收件人地址不存在，这种情况没必要继续重试
• 数据库存储：把邮件的关键信息、错误详情、重试次数都存下来，方便后续排查
• DSN配置：你原来的DSN设置是对的，开启后Gmail会把退信通知发送到你指定的recipient邮箱，配合数据库记录更完整

注意事项 #

• 如果你用587端口，记得把secure设为false，同时加上requireTLS: true，确保连接是加密的
• Gmail的SMTP有发送频率限制，批量发送时要控制速率，避免被封号
• 开启logger: true和debug: true可以帮你更清晰地看到发送过程中的日志，方便调试

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