Dart开发中使用Firebase邮箱注册功能时如何捕获异常并提示用户

在原有方法基础上通过try-catch包裹Firebase Auth异步逻辑，针对FirebaseAuthException的错误码做语义化转换即可，改造后代码如下：

// Dart 3.0+ 可用记录类型同时返回用户实例和错误信息，低版本可自定义Result封装类替代
Future<(Users? user, String? errorMsg)> createUserWithEmailAndPassword(String email, String password) async {
  try {
    final credential = await _firebaseAuth.createUserWithEmailAndPassword(
      email: email,
      password: password
    );
    return (_userFromFirebase(credential.user), null);
  } on FirebaseAuthException catch (e) {
    // 匹配错误码返回用户可理解的友好提示
    String errorMsg = switch(e.code) {
      'email-already-in-use' => '该邮箱已被注册，请直接登录或更换邮箱',
      'invalid-email' => '输入的邮箱格式不正确，请检查后重试',
      'operation-not-allowed' => '当前暂不支持邮箱密码注册，请联系管理员',
      'weak-password' => '密码强度过低，请设置至少6位的密码',
      'network-request-failed' => '网络连接异常，请检查网络后重试',
      _ => '注册失败，请稍后再试'
    };
    return (null, errorMsg);
  } catch (e) {
    // 捕获其他非Firebase相关的未知异常
    return (null, '注册失败，请稍后再试');
  }
}

使用说明 #

• 上层UI层调用时直接判断返回的错误信息是否为空即可，非空时直接将提示内容通过Toast、弹窗等形式展示给用户即可，不需要额外处理错误逻辑
• 如果你使用的Dart版本低于3.0不支持记录类型，可以选择抛出格式化后的异常让上层捕获，也可以自定义通用的Result类封装成功/失败状态
• 可根据业务需要补充更多错误码的匹配规则，覆盖更多业务场景

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