Firebase Auth发送密码重置邮件时出现未知错误如何解决？

报错翻译 #

你遇到的报错原文 Error: An unknown error occurred while sending the password reset email Firebase Auth 中文含义为：Firebase Auth 发送密码重置邮件时发生未知错误

排查解决步骤 #

• 检查Firebase控制台身份验证配置
  进入Firebase控制台→身份验证→设置→发件人模板页，确认密码重置邮件的发件人邮箱格式合法，模板内容无违规特殊字符；如果使用自定义发件人域名，需确认域名的DNS验证状态正常，无解析失效、过期问题。
• 校验接口请求参数
  调用sendPasswordResetEmail方法时传入的邮箱，需为已经在当前项目Auth用户库中注册的有效格式邮箱，不要传入空值、非法格式字符串或未注册邮箱，部分区域的Firebase节点对未注册邮箱调用该接口会直接返回未知错误。
• 确认权限与网络可用性
  前端调用时需检查Firebase安全规则未限制密码重置相关请求，客户端网络可正常访问Firebase服务，无防火墙、代理或地区访问限制拦截；服务端调用时需确认使用的服务账号拥有身份验证用户管理相关权限，密钥未过期。
• 核查项目配额使用情况
  进入Firebase控制台→使用情况和计费页，查看身份验证模块的邮件发送配额是否耗尽，免费版项目每日密码重置邮件发送配额有限，超出配额后会触发未知报错。

定位技巧：可以在调用接口的位置补充完整错误捕获逻辑，输出错误对象的code字段，Firebase Auth返回的错误码通常会给出更明确的问题指向，例如auth/user-not-found、auth/invalid-email等，可对应官方错误码说明精准处理。

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