Flutter Firebase Auth登录后无法跳转Main Page问题排查

数据老陈

2026-8-29

问题现象

集成Firebase Authentication的Flutter应用触发登录操作后，无预期页面跳转，无法进入Main Page
控制台输出日志：Notifying id token listeners about user
初步怀疑路由表中LoginPage的配置存在错误：

LoginPage.id: (context) => LoginPage(emailController: TextEditingController(), passwordController: TextEditingController(),),

报错截图参考：

注：Notifying id token listeners about user是Firebase Auth的正常INFO日志，不属于报错，仅代表SDK检测到用户id token变更、登录状态生效，不代表后续跳转逻辑会正常执行。

问题根源

一共4处核心错误，按影响优先级排序：

Firebase多实例初始化冲突
代码中使用旧版APIFirebaseApp.configure(name: 'db2')手动创建了命名为db2的非默认Firebase实例，而后续登录、数据库调用默认走的是FirebaseAuth.instance、FirebaseDatabase.instance绑定的默认实例，两个实例数据不互通：登录动作在自定义实例上完成，默认实例的数据库查询无对应登录权限，无法拿到用户数据，跳转逻辑永远不会触发。
TextEditingController重复定义、生命周期异常
LoginPage构造函数声明了emailController、passwordController作为必填入参，但类内部又重新定义了同名的成员变量，类内部变量优先级更高，导致路由中传入的控制器和输入框实际绑定的控制器不是同一个实例，输入内容读取存在异常。同时在路由表中每次构建页面都新建TextEditingController，会造成内存泄漏、状态丢失。
登录逻辑异常捕获缺失
signInWithEmailAndPassword仅通过catchError捕获部分异常，未做中断处理；后续数据库查询userRef.once()没有任何错误捕获，且数据库路径写为user/${user.uid}（常规Firebase用户表路径为复数users/${user.uid}），路径错误、权限不足时无任何提示，表现为点击登录无响应。
API版本过时
代码中使用的FirebaseUser、FirebaseApp.configure、reference()等都是旧版FlutterFire API，和当前依赖版本不兼容，会出现隐式运行错误。

修复步骤

修正Firebase初始化逻辑，使用官方标准初始化方式，删除自定义命名实例：

// main.dart中main函数替换为如下实现
Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 替换旧的FirebaseApp.configure逻辑
  await Firebase.initializeApp();
  runApp(const MyApp());
}

重构LoginPage，将TextEditingController放到State层管理，删除重复的成员变量、路由传参：

// loginPage.dart中LoginPage类简化为
class LoginPage extends StatefulWidget {
  LoginPage({Key? key}) : super(key: key);
  static const String id = 'login';

  @override
  State<LoginPage> createState() => _LoginPageState();
}

class _LoginPageState extends State<LoginPage> {
  // 控制器放到State中管理，随页面销毁释放
  final emailController = TextEditingController();
  final passwordController = TextEditingController();
  final FirebaseAuth _auth = FirebaseAuth.instance;
  final GlobalKey<ScaffoldState> scaffoldKey = GlobalKey<ScaffoldState>();

  @override
  void dispose() {
    emailController.dispose();
    passwordController.dispose();
    super.dispose();
  }

  // 原login、showSnackBar方法全部移到State内部，去掉所有widget.前缀引用
  // 原build逻辑保持不变
}

修正路由表配置，移除控制器传参：

routes: {
  RegistrationPage.id:(context) => RegistrationPage(),
  LoginPage.id: (context) => LoginPage(),
  MainPage.id: (context) => MainPage(),
},

重写登录逻辑，补全异常捕获、核对数据库路径、替换过时API：

void login(BuildContext context) async {
  try {
    final UserCredential userCred = await _auth.signInWithEmailAndPassword(
      email: emailController.text.trim(),
      password: passwordController.text.trim(),
    );
    final User? user = userCred.user;
    if(user != null){
      // 核对自己的数据库表名，是users还是user，不要写错路径
      DatabaseReference userRef = FirebaseDatabase.instance.ref().child('users/${user.uid}');
      final snapshot = await userRef.get();
      if(snapshot.exists){
        if(!mounted) return;
        Navigator.pushNamedAndRemoveUntil(context, MainPage.id, (route) => false);
      } else {
        showSnackBar('当前账号无用户信息，请先注册');
      }
    }
  } on FirebaseAuthException catch(e) {
    showSnackBar(e.message ?? '登录失败，请检查账号密码');
  } catch(e) {
    showSnackBar('登录异常：${e.toString()}');
  }
}

补全缺失依赖：代码中使用的Connectivity方法来自connectivity_plus插件，需在pubspec.yaml中添加对应依赖并导入包，否则编译报错。

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