Flutter FirebaseAuth注册时无法处理邮箱已被其他用户占用的错误

问题根因 #

你当前遇到的异常捕获失效问题，通常由以下几个原因导致：

• 调用SignUp异步方法时未添加await关键字，异常无法被方法内部的try-catch捕获，直接向上层抛出
• 低版本firebase_auth插件的异常包装逻辑存在兼容问题，邮箱重复的异常会先以PlatformException形式抛出，没有命中你写的FirebaseAuthException捕获分支
• 调试模式下IDE调试器提前拦截了未处理异常标记，实际业务逻辑已经正常捕获，但调试器会优先弹出报错提示

修复步骤 #

1. 补全异常捕获分支 #

在现有捕获逻辑基础上，新增PlatformException捕获分支和通用异常兜底，兼容不同版本插件的异常抛出逻辑：

Future SignUp() async {
    try {
      UserCredential result = await FirebaseAuth.instance
          .createUserWithEmailAndPassword(
              email: email.trim(), password: password.trim());
      User user = result.user;
      return user;
    } on FirebaseAuthException catch (e) {
      print(e);
      if (e.code == 'email-already-in-use') {
        setState(() {
          error = e.toString();
          EmailExists = true;
        });
      }
    } on PlatformException catch (e) {
      if (e.code == 'email-already-in-use') {
        setState(() {
          error = e.message ?? "该邮箱地址已被其他账号注册";
          EmailExists = true;
        });
      }
    } catch (e) {
      // 通用异常兜底，避免未捕获异常导致应用崩溃
      print("注册未知异常：$e");
    }
  }

2. 检查方法调用逻辑 #

确保你在调用SignUp方法的位置添加了await关键字，错误的调用方式会直接导致异常逃逸：

// 错误调用（异常无法被内部捕获）
SignUp();

// 正确调用
await SignUp();

3. 兼容优化 #

• 将firebase_auth插件升级到官方最新稳定版，官方已修复异常类型包装不一致的兼容问题
• 如果是调试过程中IDE弹出异常提示，可在调试设置中关闭「Uncaught Exceptions」断点触发，或运行release包验证逻辑：只要邮箱重复时EmailExists变量被正确赋值为true，说明捕获逻辑已经正常生效

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