如何将Firestore触发邮件扩展的Firebase函数升级至Gen 2

先说明下：目前Firebase官方的「Trigger Email from Firestore」扩展默认部署的还是Gen1函数，官方暂未提供一键升级到Gen2的选项，你得通过复刻扩展逻辑+自定义部署Gen2函数的方式完成升级，具体步骤如下：

• 1. 导出原扩展的配置与核心逻辑
  • 先在Firebase控制台「扩展」页找到该扩展，记下它的关键配置：监听的Firestore集合路径、发件邮箱、SMTP服务器信息、状态更新规则等。
  • 该扩展的核心逻辑很清晰：监听指定Firestore集合的文档创建/更新事件，读取文档里的邮件内容，调用SMTP服务发邮件，最后更新文档的发送状态。
• 2. 编写Gen2版本的自定义函数
  • 确保本地Firebase CLI是v11.0.0及以上版本（支持Gen2函数），在你的项目functions/src目录下新建函数文件（比如triggerEmailGen2.ts）。
  • 引入依赖后，按照Gen2的写法复刻原扩展逻辑，示例代码框架如下：

    import { onDocumentCreated, onDocumentUpdated } from "firebase-functions/v2/firestore";
    import * as admin from "firebase-admin";
    import * as nodemailer from "nodemailer";
    
    admin.initializeApp();
    
    // 用原扩展的SMTP配置初始化 transporter
    const transporter = nodemailer.createTransport({
      host: "你的SMTP服务器地址",
      port: 587,
      secure: false,
      auth: {
        user: "发件邮箱账号",
        pass: "SMTP授权码/密码",
      },
    });
    
    // 监听和原扩展相同的Firestore集合路径
    export const triggerEmailGen2 = onDocumentCreated("your-collection/{docId}", async (event) => {
      const emailDoc = event.data;
      if (!emailDoc) return;
    
      const emailData = emailDoc.data();
      // 复刻原扩展的邮件内容构建逻辑
      const mailOptions = {
        from: emailData.from || "默认发件人",
        to: emailData.to,
        subject: emailData.subject,
        html: emailData.html,
        // 按需添加cc、bcc、附件等参数
      };
    
      try {
        await transporter.sendMail(mailOptions);
        // 更新文档发送状态为成功，和原扩展逻辑一致
        await emailDoc.ref.update({
          status: "sent",
          sentAt: admin.firestore.FieldValue.serverTimestamp()
        });
      } catch (err) {
        const error = err as Error;
        await emailDoc.ref.update({
          status: "failed",
          error: error.message,
          failedAt: admin.firestore.FieldValue.serverTimestamp()
        });
        throw error;
      }
    });
    
    // 如果原扩展监听了文档更新事件，补充对应的onDocumentUpdated函数
    

• 3. 部署并测试Gen2函数
  • 执行命令firebase deploy --only functions:triggerEmailGen2部署新函数。
  • 部署完成后，写入测试文档到指定Firestore集合，验证邮件是否正常发送、文档状态是否正确更新。
• 4. 替换原扩展函数（可选）
  • 确认新函数运行正常后，可在Firebase控制台「函数」页删除原扩展生成的Gen1函数。
  • 若不再需要原扩展，可在「扩展」页卸载它，避免重复触发事件。

注意事项：

• 复刻逻辑时要完全对齐原扩展的行为，比如模板变量替换、附件处理规则等，防止业务逻辑出现偏差。
• 确保Gen2函数的服务账号拥有足够权限：Firestore读写权限、SMTP服务访问权限等。

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