Firebase Trigger Email扩展发信进入垃圾文件夹如何解决

问题场景 #

在Flutter Web开发的官网中集成Firebase Trigger Email扩展实现联系表单自动发信功能，已确认FROM发件邮箱与扩展登录账号一致，但发出的邮件全部进入收件方垃圾邮件文件夹。

扩展配置截图 #

问题邮件示例截图 #

原始发信代码 #

Future<void> _submitForm() async {
    final isValid = _key.currentState?.validate();

    if (isValid != null && isValid) {
      _key.currentState?.save();
      String message;

      try {
        final collection = FirebaseFirestore.instance.collection("mail");
        await collection.doc().set({
          "timestamp": FieldValue.serverTimestamp(),
          "to": ["Name LastName <name.lastname@domain.com>"],
          "message": {
            "subject": _subject,
            "text": "Name: ${_name}\nEmail: ${_email}"
                "\nPhone: ${_phone}\n\n${_message}"
          }
        });

        _key.currentState?.reset();

        message = "Your message has been sent successfully. We will get in "
            "contact with you.";
      } catch (_) {
        message = "Your message could not be sent. Please try again later.";
      }

      ScaffoldMessenger.of(context)
          .showSnackBar(SnackBar(content: Text(message)));
    }
  }

修复步骤 #

• 完成域名身份全链路认证
  仅保证FROM地址和登录账号一致无法满足反垃圾规则要求，Trigger Email默认通过SendGrid通道转发邮件，必须给发件域名配置三类DNS记录：
  1. 登录扩展绑定的SendGrid控制台，完成域名所有权验证，添加平台提供的3条DKIM CNAME记录
  2. 在域名DNS服务商处添加SPF TXT记录：v=spf1 include:sendgrid.net ~all
  3. 添加DMARC TXT记录，初始配置可设为监控模式：v=DMARC1; p=none; rua=mailto:admin@你的发件域名
     所有记录配置完成后等待DNS传播（最长48小时），通过邮件原始头确认SPF、DKIM、DMARC校验结果均为PASS即可。
• 修正邮件头与内容配置
  1. 不要依赖扩展默认的FROM配置，在写入Firestore的邮件文档中显式指定from字段，格式为"from": "品牌/站点名称 <已完成认证的发件邮箱@你的域名>"，禁止使用公共免费邮箱（gmail、qq、outlook等）作为发件地址。
  2. 现有代码仅发送纯文本短内容，很容易触发垃圾邮件评分，需补充HTML格式的邮件正文，同时在正文末尾添加发件方标识、误收提示，避免出现全大写、过度营销类的敏感词汇。
  3. 邮件主题增加固定识别前缀，比如[官网联系表单] 来自访客的新咨询，避免空泛、诱导性的主题内容。
• 调整发信信誉策略
  1. 新配置的发信通道初始信誉分较低，先向不同服务商的测试邮箱发送测试邮件，手动将收到的邮件标记为“非垃圾邮件”，积累初始发件信誉。
  2. 短时间内不要批量发送大量邮件，保持平稳的发信频率。
  3. 如果使用自定义SMTP服务，优先使用465（SSL）或587（TLS）端口发信，禁用无加密的25端口，同时在SMTP服务商侧开启DKIM、SPF签名。

修正后的发信代码参考 #

Future<void> _submitForm() async {
    final isValid = _key.currentState?.validate();

    if (isValid != null && isValid) {
      _key.currentState?.save();
      String message;

      try {
        final collection = FirebaseFirestore.instance.collection("mail");
        await collection.doc().set({
          "timestamp": FieldValue.serverTimestamp(),
          // 显式指定已认证的发件人地址
          "from": "官网联系表单 <no-reply@你的认证域名.com>",
          "to": ["Name LastName <name.lastname@domain.com>"],
          "message": {
            "subject": "[官网联系表单] 来自$_name的新咨询",
            // 纯文本版本正文，增加末尾标识
            "text": "Name: ${_name}\nEmail: ${_email}"
                "\nPhone: ${_phone}\n\n${_message}"
                "\n\n---\n本邮件为官网联系表单自动发送的通知，若您误收此邮件可直接忽略。",
            // 补充HTML版本正文
            "html": """
            <div style="max-width:600px;margin:0 auto;font-family:Arial,sans-serif;">
              <h3>新的官网联系表单留言</h3>
              <p><strong>姓名：</strong>$_name</p>
              <p><strong>联系邮箱：</strong>$_email</p>
              <p><strong>联系电话：</strong>$_phone</p>
              <p><strong>留言内容：</strong><br/>$_message</p>
              <hr style="border:none;border-top:1px solid #eee;margin:20px 0;"/>
              <p style="font-size:12px;color:#666;">本邮件为官网联系表单自动发送的通知，若您误收此邮件可直接忽略。</p>
            </div>
            """
          }
        });

        _key.currentState?.reset();

        message = "Your message has been sent successfully. We will get in "
            "contact with you.";
      } catch (_) {
        message = "Your message could not be sent. Please try again later.";
      }

      ScaffoldMessenger.of(context)
          .showSnackBar(SnackBar(content: Text(message)));
    }
  }

内容的提问来源于stack exchange，提问作者JAgüero