Next.js创建新用户时Firebase自动发送重置密码邮件问题

问题现象 #

• 业务逻辑：在Next.js API路由中通过Firebase Admin SDK实现新用户创建，用户创建成功后由业务侧发送包含临时密码的自定义欢迎邮件
• 异常表现：新用户完成注册后会收到2封邮件，除自定义欢迎邮件外，还会收到1封Firebase自动发出的邮件
• 异常邮件特征：邮件主题为西班牙语Cuenta Creada（意为“账户已创建”），Firebase官方无对应“账户创建”类默认邮件模板，邮件实际内容为密码重置模板内容，本地开发环境、Vercel生产环境均可稳定复现

环境版本信息 #

• Next.js：12.1.4
• Node.js：16.14.2
• Firebase JS SDK：^9.6.8
• Firebase Admin SDK：^10.2.0

现有用户创建核心代码 #

import admin from 'firebase-admin';
//...
//...
const { firstName, lastName, email, phone, idTeamLead } = req.body;
const fullName = `${firstName} ${lastName}`;
const password = generatePassword();
if (!firstName || !lastName || !email) {
  return res.status(400).send({ message: 'Missing fields' });
}
let user = null;
try {
  user = await auth.createUser({
    email: email,
    emailVerified: false,
    password: password,
    displayName: fullName,
    disabled: false,
  });
} catch (error) {
  console.log(error);
  return res.status(400).json(error);
}

问题根因 #

*firebase-admin提供的createUser方法本身不会自动触发任何Firebase邮件发送，非业务自定义的邮件一定是显式配置的触发规则、遗留云函数逻辑或代码中多余API调用导致的。结合异常邮件内容为密码重置模板、主题为自定义西班牙语的特征，触发原因大概率为以下三类：

1. Firebase控制台Authentication模块开启了「新用户创建时自动发送密码设置/重置链接」的开关，且之前修改密码重置模板时，将西班牙语版本的邮件主题自定义为了Cuenta Creada
2. 项目中部署了监听用户创建事件的Firebase Cloud Function，在onCreate触发器中遗留了调用密码重置发信接口的测试代码
3. 业务代码中存在遗漏的sendPasswordResetEmail调用，在用户创建流程中被意外触发

修复步骤 #

1. 检查Firebase控制台配置
   • 进入Firebase控制台 > 构建 > Authentication > 模板页，将邮件模板语言切换为西班牙语，找到主题为Cuenta Creada的模板，确认是否为误修改主题的密码重置模板
   • 进入Authentication > 设置 > 用户操作策略页，关闭「创建新用户时自动发送密码设置链接」类的自动发信开关——通过Admin SDK手动指定初始密码创建用户的场景不需要该功能
2. 排查云函数逻辑
   • 检查项目内的Firebase Cloud Functions代码，查找所有functions.auth.user().onCreate()类型的用户创建触发器，确认触发器内部是否存在调用sendPasswordResetEmail、generatePasswordResetLink发信逻辑的遗留测试代码，存在则直接删除
3. 排查业务代码
   • 全局搜索全项目代码（包含前端、API路由、服务端公共逻辑），查找所有调用密码重置发信相关API的位置，确认是否在用户创建流程中存在误触发逻辑，删除多余调用
4. 修复完成后创建测试用户验证，确认仅收到业务侧自定义发送的欢迎邮件即可

内容的提问来源于stack exchange，提问作者Roberto Fernández