Flutter中Firebase重置密码时reCAPTCHA令牌为空错误解决方法

核心问题拆解 #

1. 调用sendPasswordResetEmail时出现日志：Password reset request email@gmail.com with empty reCAPTCHA token
2. 输入数据库中不存在的邮箱时，无法触发正确的异常提示

问题1：空reCAPTCHA token日志处理 #

这条日志是Firebase Auth在测试环境（模拟器/真机调试）的正常输出。当应用未配置正式环境的验证信息时，Firebase会自动跳过reCAPTCHA验证流程，但会记录这条日志。生产环境中，只要完成以下配置，日志会自动消失：

• 确保通过flutterfire configure完成Flutter项目与Firebase的绑定
• 在Firebase控制台Authentication > Sign-in method中启用Email/Password登录方式
• 为Android应用添加SHA-1、SHA-256指纹到Firebase项目设置

问题2：不存在邮箱的异常修复 #

你的代码存在弹窗关闭顺序错误：捕获异常时先弹出错误对话框，再关闭加载弹窗，导致错误对话框被意外关闭。同时可以针对Firebase的异常代码，给出更友好的用户提示。

修正后的完整代码 #

import 'package:firebase_auth/firebase_auth.dart';
import 'package:flutter/material.dart';
import 'package:logginapplication/reusable_widgets/logo_widget.dart';
import '../../reusable_widgets/textFeild_widget.dart';

class ForgotPasswordScreen extends StatefulWidget {
  const ForgotPasswordScreen({super.key});

  @override
  State<ForgotPasswordScreen> createState() => _ForgotPasswordScreenState();
}

class _ForgotPasswordScreenState extends State<ForgotPasswordScreen> {
  final TextEditingController _emailTextController = TextEditingController();

  @override
  void dispose() {
    _emailTextController.dispose();
    super.dispose();
  }

  Future passwordReset() async {
    try {
      showDialog(
        context: context,
        barrierDismissible: false, // 禁止点击外部关闭加载弹窗
        builder: (context) => const Center(child: CircularProgressIndicator()),
      );
      
      await FirebaseAuth.instance.sendPasswordResetEmail(
        email: _emailTextController.text.trim(),
      );
      
      Navigator.pop(context); // 先关闭加载弹窗
      showDialog(
        context: context,
        builder: (context) => AlertDialog(
          content: const Text("密码重置邮件已发送至您填写的邮箱地址。"),
          actions: [
            TextButton(
              onPressed: () => Navigator.pop(context),
              child: const Text("确定"),
            ),
          ],
        ),
      );
    } on FirebaseAuthException catch (e) {
      Navigator.pop(context); // 先关闭加载弹窗
      String errorMessage;
      switch (e.code) {
        case 'user-not-found':
          errorMessage = "该邮箱未注册账号";
          break;
        case 'invalid-email':
          errorMessage = "邮箱格式不正确";
          break;
        default:
          errorMessage = e.message ?? "重置密码失败，请稍后重试";
      }
      showDialog(
        context: context,
        builder: (context) => AlertDialog(
          content: Text(errorMessage),
          actions: [
            TextButton(
              onPressed: () => Navigator.pop(context),
              child: const Text("确定"),
            ),
          ],
        ),
      );
    } catch (e) {
      Navigator.pop(context);
      showDialog(
        context: context,
        builder: (context) => AlertDialog(
          content: const Text("未知错误，请稍后重试"),
          actions: [
            TextButton(
              onPressed: () => Navigator.pop(context),
              child: const Text("确定"),
            ),
          ],
        ),
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      extendBodyBehindAppBar: true,
      appBar: AppBar(
        foregroundColor: Colors.black,
        backgroundColor: Colors.white10,
        elevation: 0,
      ),
      body: GestureDetector(
        onTap: () => FocusScope.of(context).requestFocus(FocusNode()),
        child: Container(
          width: MediaQuery.of(context).size.width,
          height: MediaQuery.of(context).size.height,
          decoration: const BoxDecoration(
            gradient: LinearGradient(
              colors: [Colors.white, Colors.black38, Colors.black54],
              begin: Alignment.topCenter,
              end: Alignment.bottomCenter,
            ),
          ),
          child: SingleChildScrollView(
            child: Padding(
              padding: EdgeInsets.fromLTRB(
                20,
                MediaQuery.of(context).size.height * 0.1,
                20,
                0,
              ),
              child: Column(
                children: <Widget>[
                  logoWidget("assets/images/img_2.png"),
                  const SizedBox(height: 10),
                  const Text(
                    "忘记密码",
                    style: TextStyle(
                      color: Colors.white,
                      fontWeight: FontWeight.bold,
                      fontSize: 24,
                    ),
                  ),
                  const SizedBox(height: 30),
                  const Center(
                    child: Text(
                      "请输入您注册时使用的邮箱地址，我们将发送密码重置邮件。",
                      textAlign: TextAlign.center,
                      style: TextStyle(
                        fontSize: 15,
                        color: Colors.black87,
                      ),
                    ),
                  ),
                  const SizedBox(height: 20),
                  reUseTextField(
                    "输入邮箱地址",
                    Icons.email_outlined,
                    false,
                    _emailTextController,
                  ),
                  const SizedBox(height: 10),
                  _forgotPasswordSubmitButton(),
                ],
              ),
            ),
          ),
        ),
      ),
    );
  }

  Container _forgotPasswordSubmitButton() {
    return Container(
      width: MediaQuery.of(context).size.width * 0.6,
      height: 50,
      margin: const EdgeInsets.fromLTRB(0, 10, 0, 20),
      child: ElevatedButton(
        onPressed: passwordReset,
        style: ButtonStyle(
          backgroundColor: MaterialStateProperty.resolveWith((states) {
            if (states.contains(MaterialState.pressed)) {
              return Colors.black26;
            }
            return Colors.white;
          }),
          shape: MaterialStateProperty.all<RoundedRectangleBorder>(
            RoundedRectangleBorder(borderRadius: BorderRadius.circular(30)),
          ),
        ),
        child: const Text(
          "提交",
          style: TextStyle(
            color: Colors.black87,
            fontWeight: FontWeight.bold,
            fontSize: 16,
          ),
        ),
      ),
    );
  }
}

关键修正点 #

1. 修正状态类命名：将_HomeScreenState改为_ForgotPasswordScreenState，符合组件命名规范
2. 调整弹窗关闭顺序：捕获异常时先关闭加载弹窗，再弹出错误提示，确保弹窗正常显示
3. 细分异常提示：针对user-not-found、invalid-email等常见异常给出精准提示
4. 增加通用异常捕获：处理非FirebaseAuthException的未知错误
5. 锁定加载弹窗：设置barrierDismissible: false，避免用户误操作中断流程
6. 优化方法命名：将ForgotPassworSubmitdButton改为_forgotPasswordSubmitButton，符合Dart私有方法命名规则

内容的提问来源于stack exchange，提问作者Nishada Dilshan Weerathunga