Firebase邮箱密码认证：验证邮件发送及未验证用户拦截问题求助

核心问题分析 #

你遇到的报错根源是注册流程中beforeSignIn触发器触发时，用户记录还未写入Firebase Auth数据库，此时调用admin.auth()相关方法自然找不到用户。另外，未验证邮箱的访问阻止需要同时覆盖登录拦截和应用内权限校验两个环节。

分步解决方案 #

1. 拆分验证邮件发送逻辑 #

• 注册时的验证邮件：改用afterCreate触发器，此时用户已成功创建，可正常调用Auth API生成验证链接。
• 未验证用户登录时的邮件：在beforeSignIn中处理，此时用户已存在（非首次注册场景），同时拦截登录请求。

2. 保留并优化域名校验逻辑 #

继续使用beforeCreate做注册前的域名校验，用更严谨的匹配方式避免误判。

3. 拦截未验证用户登录 #

在beforeSignIn中判断用户邮箱未验证时，先发送验证邮件，再抛出错误阻止登录。

4. 应用内权限兜底 #

即使登录拦截失效，在应用的路由/页面逻辑中额外校验user.emailVerified状态，引导用户完成邮箱验证。

完整代码实现 #

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

// 注册前校验邮箱域名
exports.beforeCreate = functions.auth.user().beforeCreate((user) => {
  if (!user?.email?.endsWith('@domain.com')) {
    // 用endsWith替代includes，避免匹配到类似xxx@domain.com.cn的无效邮箱
    throw new functions.auth.HttpsError(
      'invalid-argument', '仅允许domain.com域名的邮箱注册'
    );
  }
});

// 注册成功后发送验证邮件
exports.afterCreate = functions.auth.user().afterCreate(async (user) => {
  if (user.email && !user.emailVerified) {
    try {
      const link = await admin.auth().generateEmailVerificationLink(user.email);
      await sendCustomVerificationEmail(user.email, link, user.locale);
      functions.logger.info(`已向${user.email}发送验证邮件`);
    } catch (error) {
      functions.logger.error('发送验证邮件失败:', error);
    }
  }
});

// 登录前校验邮箱验证状态，未验证则拦截并发送邮件
exports.beforeSignIn = functions.auth.user().beforeSignIn(async (user) => {
  if (user.email && !user.emailVerified) {
    // 优先发送验证邮件
    try {
      const link = await admin.auth().generateEmailVerificationLink(user.email);
      await sendCustomVerificationEmail(user.email, link, user.locale);
    } catch (error) {
      functions.logger.error('登录时发送验证邮件失败:', error);
    }
    // 阻止未验证用户登录
    throw new functions.auth.HttpsError(
      'unauthenticated', '请先验证你的邮箱再登录'
    );
  }
});

// 自定义发送邮件函数（需自行实现具体发送逻辑，比如用nodemailer或Firebase邮件扩展）
async function sendCustomVerificationEmail(email, link, locale) {
  // 示例：替换为你的实际邮件发送逻辑
  functions.logger.info(`准备向${email}发送验证链接: ${link}`);
}

关键说明 #

• afterCreate是注册流程中唯一能确保用户记录已存在的触发器，适合发送初始验证邮件。
• beforeSignIn中先发送邮件再抛出错误，确保用户能收到验证提醒，同时拦截未授权登录。
• 域名校验用endsWith更严谨，避免误判包含目标域名的非合规邮箱。
• sendCustomVerificationEmail需要自行实现，可使用Nodemailer、Firebase SendGrid扩展等完成实际邮件发送。

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