引入模板后Firebase邮件无法发送的排查求助

问题背景 #

此前使用Firebase邮件扩展，在邮件文档创建时触发邮件发送，直接渲染长HTML字符串一切正常。近期引入模板后，邮件不再发送，但邮件文档与函数日志均显示操作成功，排除ISP问题，以下是可能不会在错误日志中显示的原因：

隐性原因分析 #

• 模板变量解析静默失败：Firebase邮件扩展的模板引擎遇到未定义变量（如{{inviteMessage}}、{{memberList}}）时，可能直接保留占位符或替换为空，生成的内容不符合SMTP投递要求，被邮件服务商悄悄丢弃，但扩展仅记录模板渲染完成，不会报错。
• HTML语法结构错误：你的模板存在未闭合标签（如<h2>中多余的</i>）、错误的表格嵌套（详情区<td>直接嵌套<tr>），这类问题会导致邮件服务商拒收，但扩展日志不会追踪SMTP投递后的环节。
• 触发反垃圾邮件规则：模板中的应用下载链接、邀请码格式，或整体布局/字体被邮件服务商的反垃圾系统判定为高风险，直接拦截但不返回错误给Firebase，因此日志显示成功但用户收不到邮件。
• 渲染后内容不符合SMTP规范：若模板变量替换后内容为空（如{{groupDescription}}无值），导致邮件结构断裂，SMTP服务器可能接受请求但不实际投递，这类情况不会触发Firebase错误日志。
• 模板配置路径隐性错误：虽然日志显示成功，但可能模板的存储路径（如Cloud Storage路径）配置有误，实际加载空白模板，渲染后内容无效，而扩展仅检测模板文件存在，不验证内容有效性。

相关截图与模板代码 #

邮件文档截图 #

模板HTML代码 #

<!DOCTYPE html>
<html>
<head>
  <title>Test Email Sample</title>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body>
    <div style="width: 100%; vertical-align: center">
  <table bgcolor=#000000 style="width: 100%; max-width: 600px;  min-height: 100vh;  margin: 0 auto;" class="home-container">
<!-- Header Section -->
    <tr>
      <td style="text-align: center;      padding: 36px;">
        <table style="width: 100%;">
          <tr style="text-align: left">
            <td style="text-align: left; width: 40px;">
              <a href="https://www.lattisapp.com">
              <img alt="image" src="https://www.lattisapp.com/images/lattisicon.jpg"
                style="width: 40px;                height: 40px;                object-fit: cover;                border-color: #000000;                border-width: 1px;                border-radius: 8px;"/>
              </a>
            </td>
            <td style="margin: 0 auto;">
              <h1 style="              text-align: left;              color: #fff;              padding-left: 8px;              font-size: 30px;              text-transform: capitalize;              font-family: 'Inter', sans-serif;">Lattis</h1>
            </td>
          </tr>
        </table>
        <!-- Rest of the header content -->
        <table style="width: 100%;        gap: 32px;        display: flex;        align-items: center;        flex-direction: column;        justify-content: flex-start;">
          <tr>
            <td>
              <h1 style="color: #fff;              max-width: 600px;              text-align: center;              font-family: 'Inter', sans-serif;              line-height: 1.6;">You&apos;ve been invited:</h1>
            </td>
          </tr>
          <tr style="border-spacing: 32px">
            <td>
              <h2 style="color: #fff;              font-size: 20px;              text-align: center;              line-height: 1.6;              font-family:'Inter',sans-serif;">{{senderName}} is inviting you to join {{groupTitle}} on Lattis{{inviteMessage}}</i></h2>
            </td>
          </tr>
          <tr>
            <td>
              <span style="color: #fff;              font-size: 16px;              font-family: 'Inter', sans-serif;">Instructions: Download Lattis with the links below. Copy your invite code, and paste it in during registration to join this group.</span>
            </td>
          </tr>
        </table>
        <!-- Hero button list -->
        <table style="flex: 0 0 auto;        width: 100%;        display: flex;        align-items: center;        justify-content: center;"
          class="hero-button-list">
          <tr>
            <td>
              <a href="https://apps.apple.com/us/app/lattis-goal-habit-tracker/id6470149396">
                <img alt="image"
                  src="https://www.lattisapp.com/images/app-store-badge.png"
                  style="width: 200px;                  object-fit: cover;                  padding: 16px;" class="apple-button" />
              </a>
            </td>
            <td>
              <a href="https://play.google.com/store/apps/details?id=com.pagefamdesigns.lattis">
                <img alt="image" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png"
                  style="width: 240px;                  object-fit: cover;                  padding: 16px;" class="android-button" />
              </a>
            </td>
          </tr>
        </table>
        <!-- Hero invite code instructions -->
        <table style="flex: 0 0 auto;        width: 100%;        align-items: center;        text-align: center;        justify-content: center;"
          class="hero-invite-code-instructions">
          <tr>
            <td style="color: #fff; font-size: 16px;            font-family: 'Inter', sans-serif; margin: 0 auto;" class="standard-text-dark">
              <span>Your invite code is:</span><br />
            </td>
          </tr>
        </table>
        <!-- Invite code container -->
        <table style="        width: 200px;        height: 50px;        display: flex;        text-align: center;        align-items: center;        border-color: #dedcdc;        border-style: solid;        border-width: 2px;        border-radius: 8px;        background-color: #868585;        margin: 0 auto;"
          class="invite-code-container">
          <tr>
            <td style="width: 200px;            color: #000000;            font-size: 24px;            line-height: 1.6;            text-align: center;            margin: 0 auto;            font-family: 'Inter', sans-serif; "
              class="invite-code">{{inviteCode}}</td>
          </tr>
        </table>
      </td>
    </tr>
  </table>
<!-- Details Section -->
    <table bgcolor="#dedcdc" style="text-align: center; width: 100%; max-width: 600px; padding-left: 36px; padding-right: 36px;    margin: 0 auto;">
    <tr>
      <td
        style="flex: 0 0 auto;        width: 100%;        max-width: 600px;        height: auto;        display: flex;        align-items: center;        justify-content: center;        "
        class="details-section">
        <table style="width: 100%;">
          <tr>
            <td style="width: 100%; display: flex; max-width: 600px; flex-direction: column; padding-bottom: 64px; justify-content: center;"
              class="details-content">
              <!-- Group Info Content -->
              <td style="flex: 1; display: flex; align-items: flex-start; flex-direction: column; justify-content: flex-start;"
                class="details-group-info">
                <tr>
                  <td>
                    <h1 style="color: #000000;                    font-family: 'Inter', sans-serif;                    font-size: 28px;                    ">Group Details</h1>
                  </td>
                </tr>
                <tr>
                  <td>
                    <h2 style="font-family: 'Inter', sans-serif;                  font-size: 24px;">Title: {{groupTitle}}</h2>
                  </td>
                </tr>
                {{groupDescription}}
              {{memberList}}
            </td>
          </tr>
        </table>
      </td>
    </tr>
    </table>
<!-- Footer Section -->
    <table bgcolor=#000000 style="margin: 0 auto;    width: 100%;    max-width: 600px;    ">
    <tr>
                  <td style="color: #fff;                  font-size: 14px;                  font-family: 'Inter', sans-serif;                  margin: 0 auto;                  padding: 48px;" class="standard-text-dark">Copyright 2024 Page Fam
                    Designs, LLC., All Rights Reserved.</td>
                </tr>
              </td>
                          </td>
    </tr>
  </table>
</div>
</body>
</html>

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