Firebase Authentication发送的验证/重置邮件页面无效问题求助

问题根源 #

该错误的核心原因是Firebase Authentication的电子邮件动作模板配置异常，导致验证/重置密码的跳转URL缺失必要的模式参数（如mode=verifyEmail或mode=resetPassword），或授权域、页面设置不匹配。

修复步骤 #

1. 检查Firebase控制台的邮件模板 #

• 登录Firebase控制台，进入目标项目 → Authentication → Templates标签页
• 分别查看「密码重置」和「电子邮件验证」模板：
  • 确保模板中完整保留{{action_url}}变量，未被手动修改或删除（该变量包含自动生成的带模式参数的跳转链接）
  • 确认模板的页面模式选择正确，若使用自定义URL，需保证URL能正确接收并处理mode参数

2. 验证授权域配置 #

• 进入Authentication → Settings → Authorized domains
• 确认邮件跳转使用的域名已添加至授权列表；若使用Firebase托管域名，需确保已完成域名关联配置

3. 刷新模板配置 #

即使配置无明显修改，尝试重新保存一次邮件模板，强制Firebase刷新配置缓存

4. 重新测试邮件功能 #

完成上述操作后，重新调用FirebaseAuth.instance.sendPasswordResetEmail()或FirebaseAuth.instance.currentUser.sendEmailVerification()，发送新邮件验证跳转是否恢复正常

额外排查项 #

• 若使用自定义邮件处理后端，需确保后端正确解析URL中的mode参数，并返回对应页面逻辑，避免忽略或错误处理该参数
• 检查项目区域/语言设置，确保模板语言与用户请求的语言匹配，避免URL生成异常

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