Flutter登录界面错误提示异常：仅输错邮箱却提示双项错误

问题分析 #

当前代码仅处理了user-not-found、invalid-email和wrong-password三种错误码，但Firebase Auth登录时还会返回其他相关错误码（比如missing-email、missing-password），未处理的错误码触发时会走到通用错误分支，导致输入错误邮箱时弹出“邮箱和密码均错误”的提示。此外缺少本地前置校验，空输入或格式错误的邮箱也可能触发未处理的错误。

解决方案 #

1. 添加本地前置校验：调用Firebase接口前，先检查邮箱是否为空、格式是否合法，密码是否为空，提前给用户反馈，减少不必要的网络请求。
2. 完善错误码覆盖：将所有邮箱相关的Firebase错误码归为邮箱错误，密码相关的归为密码错误，其他错误单独处理。

修改后的代码 #

void loginUser() async {
  // 清除输入首尾空格
  final email = emailController.text.trim();
  final password = passwordController.text.trim();

  // 本地校验：邮箱不能为空
  if (email.isEmpty) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(
        backgroundColor: Theme.of(context).colorScheme.secondary,
        content: Text(
          '邮箱不能为空', // 可替换为你的国际化字符串tEmailEmpty
          style: Theme.of(context).textTheme.bodyText1,
        ),
      ),
    );
    return;
  }

  // 本地校验：邮箱格式合法性
  final emailRegex = RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$');
  if (!emailRegex.hasMatch(email)) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(
        backgroundColor: Theme.of(context).colorScheme.secondary,
        content: Text(
          '邮箱格式错误', // 可替换为你的国际化字符串tEmailFormatIncorrect
          style: Theme.of(context).textTheme.bodyText1,
        ),
      ),
    );
    return;
  }

  // 本地校验：密码不能为空
  if (password.isEmpty) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(
        backgroundColor: Theme.of(context).colorScheme.secondary,
        content: Text(
          '密码不能为空', // 可替换为你的国际化字符串tPasswordEmpty
          style: Theme.of(context).textTheme.bodyText1,
        ),
      ),
    );
    return;
  }

  try {
    await FirebaseAuth.instance.signInWithEmailAndPassword(
      email: email,
      password: password,
    );
  } on FirebaseAuthException catch (e) {
    // 所有邮箱相关错误统一提示邮箱错误
    if (e.code == 'user-not-found' || e.code == 'invalid-email' || e.code == 'missing-email') {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(
          backgroundColor: Theme.of(context).colorScheme.secondary,
          content: Text(
            tEmailIncorrect,
            style: Theme.of(context).textTheme.bodyText1,
          ),
        ),
      );
    } 
    // 所有密码相关错误统一提示密码错误
    else if (e.code == 'wrong-password' || e.code == 'missing-password') {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(
          backgroundColor: Theme.of(context).colorScheme.secondary,
          content: Text(
            tPasswordIncorrect,
            style: Theme.of(context).textTheme.bodyText1,
          ),
        ),
      );
    } 
    // 其他错误（如用户被禁用等）显示具体提示或通用错误
    else {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(
          backgroundColor: Theme.of(context).colorScheme.secondary,
          content: Text(
            e.message ?? '登录失败，请稍后重试', // 可替换为你的国际化字符串tLoginFailed
            style: Theme.of(context).textTheme.bodyText1,
          ),
        ),
      );
    }
  } 
  // 捕获非FirebaseAuth异常
  catch (e) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(
        backgroundColor: Theme.of(context).colorScheme.secondary,
        content: Text(
          '登录失败，请稍后重试', // 可替换为你的国际化字符串tLoginFailed
          style: Theme.of(context).textTheme.bodyText1,
        ),
      ),
    );
  }
}

说明 #

• 本地校验可以快速反馈用户输入问题，避免无效的Firebase请求；
• 扩展错误码覆盖范围后，所有邮箱相关的错误都会触发“邮箱错误”提示，密码相关错误触发“密码错误”提示；
• 其他异常（如网络错误、用户被禁用）会显示更合适的提示，避免混淆用户。

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