Firebase Functions发邮件遇550 5.7.1错误，求正确SPF配置

你遇到的Error: Mail command failed: 550 5.7.1错误，本质是收件方邮件服务器的SPF验证未通过，核心问题是当前SPF记录包含了多余的未使用发送源，或配置不符合规则。以下是正确的SPF配置思路和要点：

核心配置原则 #

只保留你实际使用的邮件发送服务商的SPF规则，多余的include会增加DNS查询次数（SPF验证最多允许10次DNS查询），反而可能导致验证失败。

分场景的正确SPF记录 #

• 仅使用Firebase Trigger Email扩展：

  v=spf1 include:_spf.firebasemail.com ~all
  

• 同时使用Firebase Trigger Email + SendGrid：

  v=spf1 include:_spf.firebasemail.com include:sendgrid.net ~all
  

• 同时使用Firebase + Google Workspace/Gmail + SendGrid：

  v=spf1 include:_spf.firebasemail.com include:_spf.google.com include:sendgrid.net ~all
  

  注：~all表示软失败（验证不通过时邮件仍可能被接收但标记），若需严格验证可改为-all，建议先软失败测试正常后再调整。

额外必查项 #

• 确保域名仅存在一条SPF TXT记录，多条SPF记录会直接导致验证失败。
• 确认MX记录配置正确：若使用自定义域名发件，MX记录需指向对应邮件服务商的服务器；若用Firebase托管的域名，需匹配Firebase要求的MX记录。
• 用DNS查询命令（如dig yourdomain.com TXT）确认SPF记录已生效，返回内容需与你配置的一致。
• 发件邮箱的域名必须与配置SPF记录的域名一致（例如发件人是admin@yourdomain.com，SPF需配置在yourdomain.com下）。

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