基于Firebase存储的邮箱地址自动发送纪念日邮件的最优方案问询

阿华AIGC实验室

2026-5-21

最优实现方案：基于Firebase生态的纪念日自动邮件发送系统

嘿，这个需求我刚好帮几个客户落地过，基于Firebase生态来实现是最顺畅的——不用额外搭建太多外部服务，完全依托Firebase的工具链就能搞定，给你拆解下最优路径：

1. 先把数据存对地方：从Storage转到Firestore

别再把用户邮箱和纪念日存在Firebase Storage里了！Storage适合存文件，而带结构化属性（生日、订阅状态等）的用户数据，放在Firestore才是正确选择，后续查询筛选效率会高很多。

你可以给每个用户建一个文档，结构大概是这样：

// Firestore用户文档示例
{
  email: "user@example.com",
  fullName: "John Doe",
  birthday: Timestamp.fromDate(new Date(1990, 4, 20)), // 存储为Date类型，方便后续日期匹配
  sendChristmasEmail: true, // 标记是否接收圣诞邮件
  unsubscribeToken: "random-uuid-123" // 可选，用于生成取消订阅链接
}

2. 定时触发：用Firebase Cloud Functions的定时任务

要实现生日、圣诞等节点的自动发送，用Firebase Cloud Functions的Pub/Sub定时触发器就够了。它支持按CRON表达式设置运行时间，比如每天凌晨检查一次当天需要发送邮件的用户。

举个代码例子：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

// 每天凌晨1点（纽约时区）运行一次邮件发送任务
exports.sendAnniversaryEmails = functions.pubsub.schedule("0 1 * * *")
  .timeZone("America/New_York")
  .onRun(async (context) => {
    const db = admin.firestore();
    const today = new Date();

    // 1. 查询当天过生日的用户（匹配月和日，忽略年份）
    const birthdayUsers = await db.collection("users")
      .where(admin.firestore.FieldValue.datePart("month", "birthday"), "==", today.getMonth())
      .where(admin.firestore.FieldValue.datePart("day", "birthday"), "==", today.getDate())
      .get();

    // 2. 如果当天是圣诞节，查询订阅圣诞邮件的用户
    let christmasUsers = [];
    if (today.getMonth() === 11 && today.getDate() === 25) {
      christmasUsers = await db.collection("users").where("sendChristmasEmail", "==", true).get();
    }

    // 合并需要发送邮件的用户列表
    const usersToEmail = [...birthdayUsers.docs, ...christmasUsers.docs];

    // 调用邮件发送函数
    await sendEmailsToUsers(usersToEmail);

    return null;
  });

3. 邮件发送：集成第三方邮件服务（以SendGrid为例）

Firebase本身没有邮件发送服务，所以我们需要集成第三方工具，SendGrid是个不错的选择——免费额度足够小批量发送，API也容易对接。

步骤很简单：

在SendGrid后台创建API密钥，然后用Firebase CLI把密钥存入环境变量：firebase functions:config:set sendgrid.key="你的API密钥"
在Cloud Functions里写发送逻辑：

const sgMail = require("@sendgrid/mail");
const functions = require("firebase-functions");

// 从环境变量读取SendGrid密钥
sgMail.setApiKey(functions.config().sendgrid.key);

async function sendEmailsToUsers(userDocs) {
  const failedSends = [];

  for (const doc of userDocs) {
    const user = doc.data();
    let subject, htmlContent;

    // 判断邮件类型（生日/圣诞）
    const today = new Date();
    if (user.birthday && user.birthday.toDate().getMonth() === today.getMonth() && user.birthday.toDate().getDate() === today.getDate()) {
      subject = `Happy Birthday, ${user.fullName}! 🎉`;
      htmlContent = `<p>Hey ${user.fullName}, hope you have an amazing birthday today—we're cheering you on!</p>`;
    } else {
      subject = "Merry Christmas from Us! 🎄";
      htmlContent = `<p>Hi ${user.fullName}, warm wishes for a cozy, joyful Christmas with your loved ones.</p>`;
    }

    // 必须加入取消订阅链接（符合反垃圾邮件法规）
    htmlContent += `<p>Want to unsubscribe? <a href="https://你的项目域名.firebaseapp.com/unsubscribe?token=${user.unsubscribeToken}">Click here</a></p>`;

    const msg = {
      to: user.email,
      from: "你的发件邮箱@example.com", // 记得在SendGrid验证这个邮箱
      subject: subject,
      html: htmlContent,
    };

    try {
      await sgMail.send(msg);
      functions.logger.info(`邮件已发送给 ${user.email}`);
    } catch (error) {
      functions.logger.error(`发送失败给 ${user.email}:`, error);
      failedSends.push({ email: user.email, error: error.message, timestamp: new Date() });
    }
  }

  // 把发送失败的记录存入Firestore，方便后续重试
  if (failedSends.length > 0) {
    const db = admin.firestore();
    const batch = db.batch();
    failedSends.forEach(fail => {
      const docRef = db.collection("failedEmails").doc();
      batch.set(docRef, fail);
    });
    await batch.commit();
  }
}