Firebase Cloud Function发送的验证邮件用户未收到问题排查求助

我在使用Firebase Cloud Function发送用户邮箱验证邮件时遇到问题：函数执行显示成功，日志也打印了"Verification email sent to: [uid]"，但多个用户反馈始终未收到验证邮件，不同邮箱地址都出现这个情况。

问题代码 #

exports.sendEmailVerification = functions.https.onCall(
    async (data, context) => {
      try {
        const user = context.auth;

        if (!user) {
          throw new functions.https.HttpsError(
              "invalid-argument", "User not authenticated");
        }

        const uid = user.uid;

        // Trigger the email verification process
        await admin.auth().updateUser(uid, {
          emailVerified: false,
        });

        console.log("Verification email sent to:", uid);
        return {success: true};
      } catch (error) {
        console.error("Error sending verification email:", error);
        throw new functions.https.HttpsError(
            "internal", "Error sending verification email");
      }
    });

已执行的排查步骤 #

• 确认收件人邮箱地址正确
• 验证收件人邮箱可正常接收其他邮件
• 检查Firebase项目的邮箱验证模板及发送配置
• 确认Firebase邮件发送配额未超出
• 查看Cloud Function日志，未发现邮件发送相关错误或警告

补充信息 #

• Cloud Function日志仅打印了"Verification email sent to: [uid]"，无任何错误输出
• 测试了多个不同域名的邮箱（如Gmail、企业邮箱），均无法收到邮件

核心问题定位与解决思路 #

1. 代码逻辑错误（根本原因） #

你的代码仅执行了admin.auth().updateUser(uid, {emailVerified: false})，这个操作只会将用户的emailVerified字段设为false，完全不会触发邮箱验证邮件的发送。日志里的"Verification email sent to"是你自己打印的，并非Firebase确认邮件已发送的官方日志。

2. 修正方案 #

方案1：后端触发邮件发送（使用Firebase Auth生成验证链接）

通过admin.auth().generateEmailVerificationLink()生成官方验证链接，再用第三方邮件服务（如Nodemailer、SendGrid）发送：

// 修正后的核心代码片段
const userRecord = await admin.auth().getUser(uid);
const verificationLink = await admin.auth().generateEmailVerificationLink(userRecord.email);

// 示例用Nodemailer发送（需先安装nodemailer依赖：npm install nodemailer）
const nodemailer = require('nodemailer');
const transporter = nodemailer.createTransport({
  service: 'Gmail', // 或其他邮件服务
  auth: {
    user: '你的发件邮箱',
    pass: '邮箱授权码'
  }
});

await transporter.sendMail({
  from: '你的验证邮箱 <your-email@example.com>',
  to: userRecord.email,
  subject: '请验证你的邮箱',
  html: `<p>点击下方链接完成邮箱验证：</p><a href="${verificationLink}">验证邮箱</a>`
});

console.log("Verification email sent to:", userRecord.email);

方案2：前端直接触发（官方推荐，更简单）

如果场景允许，让前端调用Firebase Auth内置的sendEmailVerification()方法，无需后端函数：

// 前端Web代码示例
firebase.auth().currentUser.sendEmailVerification()
  .then(() => {
    alert('验证邮件已发送，请查收');
  })
  .catch((error) => {
    console.error('发送失败：', error);
  });

3. 额外排查步骤 #

• 检查Firebase Auth邮件配置：进入Firebase控制台→认证→模板→邮箱验证，确认模板已启用，发件人邮箱已通过验证；若开启自定义域名发送，需确保域名的SPF、DKIM记录配置正确。
• 查看Firebase Auth专属日志：进入Firebase控制台→认证→日志，筛选"邮件发送"相关事件，这里会显示Auth层面的邮件发送状态（Cloud Function日志不会记录这些）。
• 测试验证链接有效性：手动生成验证链接并访问，确认能否正常标记用户邮箱为已验证，排除链接无效问题。
• 检查邮箱拦截规则：让用户检查垃圾邮件箱、垃圾箱，确认Firebase发件域名（如@firebaseemail.com）未被邮箱服务商拉黑。

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