使用Firebase Authenticator登录主页时出现认证错误

核心错误原因 #

你遇到的[firebase_auth/wrong-password] The password is invalid or the user does not have a password错误，指向两种明确情况：

• 输入的密码与该邮箱对应的Firebase用户密码不匹配
• 该用户并非通过「邮箱/密码」方式创建（比如用Google、Apple等第三方登录生成的用户本身无密码）

解决步骤 #

1. 基础信息校验

   • 仔细核对输入的密码，注意大小写、特殊字符，避免空格或拼写错误
   • 登录Firebase控制台，确认该邮箱在用户列表中存在，且是通过「邮箱/密码」认证方式创建的

2. 优化代码逻辑与错误处理
   原代码缺少异常捕获和登录成功后的跳转逻辑，修改后可明确错误原因并完成页面跳转：

void signUserIn() async{
  try {
    // 去除输入内容前后空格，避免空格导致的匹配失败
    await FirebaseAuth.instance.signInWithEmailAndPassword(
      email: emailController.text.trim(),
      password: passwordController.text.trim(),
    );
    // 登录成功后替换当前页面栈，跳转到主页
    Navigator.pushReplacement(context, MaterialPageRoute(builder: (context) => HomePage()));
  } on FirebaseAuthException catch (e) {
    // 根据错误码给出对应提示
    String message;
    switch(e.code) {
      case 'wrong-password':
        message = '密码错误，请重新输入';
        break;
      case 'user-not-found':
        message = '该邮箱未注册';
        break;
      case 'invalid-email':
        message = '邮箱格式不正确';
        break;
      default:
        message = '登录失败：${e.message}';
    }
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text(message)),
    );
  }
}

3. 额外检查项
   • 确认Firebase项目「Authentication」模块中已启用「邮箱/密码」登录方式
   • 检查登录页面输入框是否正确绑定emailController和passwordController（即TextField的controller属性是否对应设置）
   • 可先在Firebase控制台手动创建测试用户，用该用户的邮箱密码测试登录，排除注册环节问题

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