Firebase重置密码链接未送达 非Gmail域名收不到重置邮件问题

• 先核对两类邮件的模板配置差异
  Firebase的邮箱验证、密码重置邮件是完全独立的两个配置项，不要默认两者配置一致。进入Firebase控制台的Authentication-Templates页面，分别打开两个模板的配置页逐项核对：
  • 核对发件人地址：如果重置密码模板用了未完成域名所有权验证的自定义发件域名，企业/学校邮箱的反垃圾网关会直接在传输层丢弃邮件，根本不会进收件箱或垃圾文件夹；如果邮箱验证模板用的是默认的noreply@firebaseapp.com发件，就能正常送达。
  • 核对跳转链接配置：如果重置密码模板配了自定义的跳转链接域名，要确认该域名已经加入Firebase授权域名列表，且域名的SPF、DKIM解析记录配置正确。企业邮局对带跳转链接的密码类邮件校验极严，只要链接域名的发件授权记录异常，会直接静默丢弃邮件。
• 查Firebase端的投递日志
  进入Firebase控制台Authentication-Email templates页面的投递日志入口，筛选对应非Gmail邮箱的重置密码发件记录：
  • 如果日志显示投递成功但用户没收到，说明是收件方企业/学校的邮件网关拦截，需要联系对方IT将Firebase的发件IP、发件域名加入白名单。
  • 如果日志显示退信，记录里会直接标注退信原因，常见原因包括收件方邮局判定为钓鱼邮件、收件域拒收无有效SPF签名的密码类邮件、收件域设置了外部密码重置邮件全局拦截规则。
• 核对前端代码的接口调用参数
  检查代码中sendPasswordResetEmail方法的入参配置：
  • 不要给重置密码接口传入和邮箱验证接口不一致、且未加入授权列表的域名作为continueUrl参数，企业邮箱的反钓鱼规则会直接拦截链接域和发件域不一致的密码重置邮件。
  • 确认没有错误设置handleCodeInApp: true但未配套配置对应端的链接接收逻辑，这种情况下生成的重置链接格式异常，部分反垃圾系统会直接判定为恶意链接丢弃邮件。
• 排查自定义SMTP配置问题
  如果你在Firebase中配置了第三方SMTP服务替代默认发件通道，要确认密码重置邮件的发件通道没有配置错误，且对应SMTP发件域名已经配置了正确的SPF、DKIM、DMARC记录。密码重置类邮件对发件域名的身份校验要求远高于普通验证邮件，缺任意一项授权记录都可能被企业邮局拒收。
• 确认收件方网关的拦截规则
  企业、学校的自建邮局通常会对密码类邮件设置更高的安全拦截等级：普通邮箱验证邮件因为不涉及账号密码修改操作，反垃圾评分低，可正常送达；而密码重置邮件因为包含“重置密码”类敏感关键词+操作链接，一旦发件方信誉分稍低就会被直接在网关层丢弃，不会进入用户的垃圾文件夹。可以联系企业/学校IT部门查询网关拦截日志，确认是否有对应邮件被拦截的记录，临时加白后再测试。

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