Firebase Cloud Functions无法发送用户资料变更邮件及合并邮件需求

核心问题分析 #

原代码有两个关键问题：一是字段访问语法错误，导致变更判断失效，邮件根本不会触发；二是每变更一个字段就发一封邮件，造成冗余。以下是针对性的修复和优化方案：

1. 修复字段访问错误 #

原代码里用oldProfile.info这种点语法是错误的——info是循环变量，必须用方括号语法oldProfile[info]才能正确访问动态字段，否则会去读取名为info的固定字段（你的数据里根本没有这个字段），导致变更判断永远不成立，这就是邮件没发送的核心原因。

2. 合并变更为单封邮件 #

先遍历所有字段，把有变更的内容统一收集起来，最后一次性生成邮件发送，避免多封邮件的困扰。同时要确保异步操作被正确等待，防止Cloud Functions提前终止进程。

修正后的完整代码 #

exports.profileUpdateEmail = functions.firestore
  .document(`profiles/{profile}`)
  .onUpdate(async (change) => {
    const oldProfile = change.before.data();
    const newProfile = change.after.data();
    // 补充完整你的20+个字段
    const profileFields = ["userName", "name", "email"];

    // 收集所有变更项的HTML片段
    const changesHtml = [];
    for (const field of profileFields) {
      const oldValue = oldProfile[field];
      const newValue = newProfile[field];
      // 基础类型的变更判断，复杂类型（对象/数组）需用深度比较
      if (oldValue !== newValue) {
        changesHtml.push(`
          <p>
            <b>${field}</b><br>
            Before: ${oldValue || "空"}<br>
            After: ${newValue || "空"}
          </p>
        `);
      }
    }

    // 没有变更就直接返回，不发邮件
    if (changesHtml.length === 0) {
      console.log("No profile changes detected");
      return null;
    }

    // 构建最终邮件内容
    const mailOptions = {
      from: `"Admin" <${process.env.REACT_OUTGOING_EMAIL}>`,
      to: process.env.REACT_OUTGOING_EMAIL,
      subject: `Professional Profile Update of ${oldProfile.userName}`,
      html: `
        <h1>Profile Changes</h1>
        <p><b>UserID: </b>${oldProfile.user}</p>
        ${changesHtml.join("")}
      `
    };

    try {
      await transporter.sendMail(mailOptions);
      console.log("Profile Update Email Sent!");
      return null;
    } catch (error) {
      console.error("Error sending mail:", error);
      return null;
    }
  });

额外优化建议 #

• 复杂字段深度比较：如果你的资料包含对象、数组这类复杂类型，!==无法正确识别变更，可以自己实现深度比较函数，或者用lodash的isEqual方法。
• 空值友好处理：代码里用oldValue || "空"避免字段为空时显示undefined，提升邮件可读性。
• 异步操作管控：确保所有异步操作都用await等待，防止Cloud Functions在邮件发送完成前就终止进程。

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