Flutter集成Firebase时如何实现新用户显示欢迎页、已登录用户直接进主页

核心逻辑 #

Firebase Auth默认会持久化用户登录状态，应用冷启动时可直接读取当前登录用户实例，不需要额外做本地缓存。我们通过监听Auth状态流来动态决定初始路由即可。

操作步骤 #

• 先确认你的pubspec.yaml中已引入firebase_auth依赖，版本与现有Firebase相关依赖匹配：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^你的现有版本
  firebase_auth: ^匹配对应版本

执行flutter pub get完成依赖安装。

• 修改main.dart代码如下：

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:flutter/material.dart';
import 'package:masterpass/Screens/Welcome/welcome_screen.dart';
// 导入你的主页类，替换为实际路径
import 'package:masterpass/Screens/Home/home_screen.dart';
import 'package:masterpass/components/constants.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'MasterPass',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primaryColor: kPrimaryColor,
        scaffoldBackgroundColor: Colors.white,
      ),
      // 用StreamBuilder监听登录状态变化
      home: StreamBuilder(
        stream: FirebaseAuth.instance.authStateChanges(),
        builder: (context, snapshot) {
          // 加载状态下显示圆形加载指示器
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Scaffold(
              body: Center(child: CircularProgressIndicator(color: kPrimaryColor)),
            );
          }
          // 有用户数据说明已登录，直接进入主页
          if (snapshot.hasData) {
            return const HomeScreen();
          }
          // 未登录/已登出状态进入欢迎页
          return const WelcomeScreen();
        },
      ),
    );
  }
}

注意事项 #

• 你需要将代码中的HomeScreen替换为项目实际的主页类名以及对应导入路径
• 用户主动调用FirebaseAuth.instance.signOut()后，authStateChanges()会返回空值，下次启动应用会自动进入欢迎页，符合需求
• 加载状态的占位页可以根据你项目的设计风格自定义，避免启动时的白屏或闪跳

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