Flutter Firebase Authentication异常无法被Try-Catch捕获问题求助

问题重现 #

使用Firebase邮箱密码认证时，调用signInWithEmailAndPassword方法的try-catch无法捕获异常，导致执行阻塞。测试输入错误密码、未注册邮箱、格式错误邮箱均会触发该问题。使用版本：

• Flutter: 3.16.5
• Dart: 3.2.3
• firebase_core: 2.24.2
• firebase_auth: 4.15.3

原代码：

Future<void> signInWithEmailAndPassword(
      {required String email, required String password}) async {
    try {
      UserCredential credential = await FirebaseAuth.instance
          .signInWithEmailAndPassword(email: email, password: password);
    } catch (e) {
      print(e);
    }
  }

解决方案 #

1. 捕获具体的FirebaseAuthException #

Firebase Auth抛出的异常属于FirebaseAuthException类型，针对性捕获可精准处理不同错误场景，同时保留通用catch兜底：

Future<void> signInWithEmailAndPassword({
  required String email,
  required String password,
}) async {
  try {
    final credential = await FirebaseAuth.instance.signInWithEmailAndPassword(
      email: email,
      password: password,
    );
    // 登录成功后的逻辑
  } on FirebaseAuthException catch (e) {
    // 处理Firebase认证特定错误
    print('认证错误: ${e.code} - ${e.message}');
    // 根据错误码做对应处理
    switch (e.code) {
      case 'invalid-email':
        // 邮箱格式错误提示
        break;
      case 'user-not-found':
        // 用户不存在提示
        break;
      case 'wrong-password':
        // 密码错误提示
        break;
      case 'user-disabled':
        // 用户被禁用提示
        break;
      default:
        // 其他错误提示
    }
  } catch (e) {
    // 处理非Firebase认证类异常
    print('未知错误: $e');
  }
}

2. 确保异步调用方式正确 #

在TextButton的onPressed中，必须用匿名函数包裹异步方法调用，避免方法立即执行或上下文丢失：

TextButton(
  onPressed: () async {
    await signInWithEmailAndPassword(
      email: yourEmailController.text,
      password: yourPasswordController.text,
    );
    // 登录完成后的后续逻辑
  },
  child: const Text('登录'),
)

3. 确认Firebase初始化完成 #

在调用任何Firebase服务前，必须确保Firebase已初始化，在main函数中添加：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(const YourApp());
}

4. 区分Debug日志与未捕获异常 #

Debug模式下Firebase会自动打印认证错误日志，这是正常的调试输出，不代表异常未被捕获。可通过自己代码中的print输出确认异常是否进入catch块。

总结 #

通过以上步骤，就能正常捕获并处理Firebase邮箱密码认证的各类异常，解决执行阻塞问题。

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