Flutter集成Firebase时重置密码邮件未发送问题排查

核心原因分析 #

从日志里的Password reset request stacks@example.com with empty reCAPTCHA token信息来看，问题主要出在以下两点：

• reCAPTCHA验证未完成：Firebase Auth默认对未验证的应用启用reCAPTCHA保护，防止密码重置接口被滥用。你的代码直接调用sendPasswordResetEmail，但没有触发或完成reCAPTCHA验证流程，导致请求被拦截，邮件无法发出。
• 应用配置不完整：如果你的Flutter应用未在Firebase控制台完成SHA指纹配置、包名/Bundle ID与控制台记录不匹配，Firebase会判定应用为未验证状态，强制要求reCAPTCHA验证，而你的代码未处理该流程，最终导致请求失败。

解决步骤 #

1. 完善Firebase应用配置

   • 登录Firebase控制台，进入项目的项目设置 -> 应用页面
   • 检查Android/iOS应用的包名/Bundle ID是否与代码中的一致
   • Android端：添加应用的SHA-1和SHA-256指纹（调试阶段可通过命令keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey获取）
   • 重新下载google-services.json（Android）或GoogleService-Info.plist（iOS），替换项目中的旧配置文件

2. 添加异常捕获排查问题
   修改newPasswordLink方法，捕获并打印异常信息，便于精准定位问题：

   Future<void> newPasswordLink(BuildContext context) async {
     try {
       await _auth.sendPasswordResetEmail(email: fieldTextControl.text.trim());
       ScaffoldMessenger.of(context).showSnackBar(
         const SnackBar(content: Text('密码重置邮件已发送，请查收'))
       );
     } catch (e) {
       print('发送失败：$e');
       ScaffoldMessenger.of(context).showSnackBar(
         SnackBar(content: Text('发送失败：${e.toString()}'))
       );
     }
   }
   

   注意：由于当前是StatelessWidget，需要将组件改为StatefulWidget，或者在调用时传递context，确保能弹出提示。

3. 确保reCAPTCHA验证流程正常触发
   配置完成后，再次测试时Firebase会自动弹出reCAPTCHA验证界面（调试阶段可能为网页形式），完成验证后即可正常发送邮件。

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