Flutter应用重启时先显登录页再跳转首页的问题排查与解决

核心问题在于启动时用户状态校验未完成就先渲染了AuthScreen，后续校验完成后才跳转目标页面，导致闪现。即使加了闪屏页，如果闪屏页没等校验完成就跳转，同样会出现这个问题。以下是具体解决方案：

1. 调整页面路由逻辑 #

把SplashScreen设为应用初始页面，所有用户状态校验都在闪屏页内完成，校验结束后再跳转到对应页面，避免中途渲染AuthScreen。

2. 修改main.dart路由配置 #

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '你的应用名称',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: const SplashScreen(), // 初始页固定为闪屏
      routes: {
        '/auth': (context) => const AuthScreen(),
        '/home': (context) => const BottomBar(),
        '/admin': (context) => const AdminScreen(),
      },
    );
  }
}

3. 重写SplashScreen，内置状态校验逻辑 #

闪屏页在初始化时完成用户登录状态和权限校验，期间显示加载动画，直到校验完成再跳转：

class SplashScreen extends StatefulWidget {
  const SplashScreen({super.key});

  @override
  State<SplashScreen> createState() => _SplashScreenState();
}

class _SplashScreenState extends State<SplashScreen> {
  final AuthService _authService = AuthService();

  @override
  void initState() {
    super.initState();
    _checkAuthAndNavigate();
  }

  Future<void> _checkAuthAndNavigate() async {
    // 等待AuthService完成用户状态初始化
    final currentUser = await _authService.getCurrentUser();
    
    if (!mounted) return; // 防止页面已销毁时跳转

    if (currentUser != null) {
      // 校验用户是否为管理员
      bool isAdmin = await _authService.isUserAdmin(currentUser.uid);
      if (isAdmin) {
        Navigator.pushReplacementNamed(context, '/admin');
      } else {
        Navigator.pushReplacementNamed(context, '/home');
      }
    } else {
      Navigator.pushReplacementNamed(context, '/auth');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 替换成你的应用Logo或闪屏动画
            const Icon(Icons.android, size: 120, color: Colors.blue),
            const SizedBox(height: 30),
            const CircularProgressIndicator(strokeWidth: 2), // 加载提示
          ],
        ),
      ),
    );
  }
}

4. 优化AuthService的状态校验方法 #

确保getCurrentUser等待Auth状态初始化完成，而不是直接返回可能为null的缓存值：

class AuthService {
  final FirebaseAuth _auth = FirebaseAuth.instance;
  final FirebaseFirestore _firestore = FirebaseFirestore.instance;

  // 等待Auth状态初始化完成后返回当前用户
  Future<User?> getCurrentUser() async {
    // 监听Auth状态变化，拿到第一个有效状态
    await _auth.authStateChanges().first;
    return _auth.currentUser;
  }

  // 校验用户是否为管理员（根据你的数据库逻辑调整）
  Future<bool> isUserAdmin(String uid) async {
    final userDoc = await _firestore.collection('users').doc(uid).get();
    return userDoc.data()?['isAdmin'] ?? false;
  }
}

关键说明 #

• 避免在main.dart中直接用StreamBuilder监听Auth状态：启动时Stream可能先返回null，导致先渲染AuthScreen，后续拿到用户数据再跳转，引发闪现。
• 闪屏页必须等待所有异步校验完成后再跳转：期间显示加载动画，让用户明确知道应用正在初始化，同时避免中间页面的闪现。
• 用pushReplacementNamed跳转：替换当前路由栈，防止用户返回闪屏页。

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