使用Nodemailer调用Namecheap PrivateEmail发送邮件失败排查

• 先查垃圾箱
  别着急改代码，先去收件方邮箱的垃圾邮件/ spam文件夹找，测试邮件大概率会被Gmail、Outlook这类邮箱判定为垃圾邮件，尤其是首次发送的陌生发件人邮件。

• 核对加密配置与端口的匹配
  PrivateEmail的SMTP端口对应固定加密方式，配置错误会导致邮件投递失败：

  • 465端口：必须开启SSL加密，Nodemailer配置示例：

    const transporter = nodemailer.createTransport({
      host: 'mail.privateemail.com',
      port: 465,
      secure: true, // 此选项必须设为true
      auth: {
        user: 'your-full-email@your-domain.com',
        pass: 'your-privateemail-password'
      }
    });
    

  • 587端口：使用STARTTLS加密，配置示例：

    const transporter = nodemailer.createTransport({
      host: 'mail.privateemail.com',
      port: 587,
      secure: false,
      requireTLS: true, // 强制开启STARTTLS
      auth: {
        user: 'your-full-email@your-domain.com',
        pass: 'your-privateemail-password'
      }
    });
    

• 确保发件人地址与SMTP账户完全一致
  PrivateEmail不允许用非SMTP认证账户的邮箱作为发件人，比如你用admin@yourdomain.com登录SMTP，发件人就必须是这个邮箱，不能填no-reply@yourdomain.com（除非你用该账户登录SMTP）。

• 检查邮件内容是否触发垃圾邮件规则
  验证码邮件要尽量合规：

  • 主题明确，比如「XX网站注册验证码」，避免用太泛的营销类词汇
  • 正文需说明来源，比如「你正在XX网站注册，验证码是：XXXXXX」，别只发一串数字
  • 避免大量大写、特殊符号，测试阶段尽量不要加可疑链接

• 查看PrivateEmail的邮件投递日志
  登录PrivateEmail后台，找到「邮件日志」（一般在邮件设置板块），搜索你发送的测试邮件，日志会显示具体投递状态：

  • 若显示「已投递」，问题出在收件方邮箱；
  • 若显示「被拒收」，会附带错误码（比如550表示收件方服务器拒绝，554表示内容违规），可根据错误码针对性解决。

• 配置DKIM/SPF DNS记录
  未正确配置这两项，邮件几乎会被所有收件方服务器拦截：

  • SPF记录：在Namecheap域名管理的DNS设置中，添加一条TXT记录，内容为v=spf1 include:spf.privateemail.com ~all
  • DKIM记录：登录PrivateEmail后台，找到「DKIM设置」生成对应密钥，然后在域名DNS中添加一条TXT记录，主机名一般为dkim._domainkey，值为PrivateEmail提供的密钥内容

• 检查PrivateEmail的反垃圾设置
  登录PrivateEmail后台，查看「反垃圾邮件」规则，确认目标邮箱域名未被加入黑名单，同时不要开启过于严格的出站过滤规则，避免自身邮件被拦截。

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