Flutter中FirebaseAuth登录自定义错误消息实现求助

要实现自定义登录错误提示，核心是利用FirebaseAuthException的code字段，而非直接返回默认的message。你可以通过建立错误码与自定义提示的映射表，将官方错误码转换成更贴合用户的中文提示。

1. 定义错误码-自定义消息映射表 #

在你的Auth类（或登录函数所在文件）中，先定义一个映射表，把常用的Firebase Auth错误码对应成自定义中文提示：

final Map<String, String> _authErrorMessages = {
  'user-not-found': '该邮箱未注册，请先完成注册',
  'wrong-password': '密码错误，请重新输入',
  'invalid-email': '邮箱格式不正确，请检查后重试',
  'user-disabled': '该账号已被禁用，请联系管理员',
  'too-many-requests': '操作过于频繁，请稍后再试',
  // 可根据需求添加更多错误码的自定义提示
};

2. 修改登录函数 #

修改loginOlimUser函数，捕获异常后通过错误码从映射表中匹配自定义消息，无匹配时再用默认消息：

Future loginOlimUser(String email, String password) async {
  try {
    User user = (await _auth.signInWithEmailAndPassword(
            email: email, password: password))
        .user!;
    // 登录成功返回true，匹配调用方的判断逻辑
    return true;
  } on FirebaseAuthException catch (e) {
    // 优先用自定义消息，无匹配则用默认提示
    return _authErrorMessages[e.code] ?? e.message ?? '登录失败，请稍后再试';
  } catch (e) {
    // 捕获其他未知异常
    return '登录异常，请稍后再试';
  }
}

注意：原代码登录成功时无返回值，必须加上return true;，否则调用方的value == true判断会失效。

3. 调用逻辑无需改动 #

你的登录按钮点击事件和SnackBar实现代码保持原样即可，现在登录失败时会自动展示你定义的自定义提示消息。

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