跨平台开发 / 系统课时

让登录状态驱动页面变化

让登录状态驱动页面变化

如果每个页面都写一次“未登录就跳登录页”,导航逻辑会迅速分散。本课把认证状态提升到应用入口,由一个根组件统一决定显示登录页、加载页还是主界面;子页面不再重复判断登录状态。

学习目标

  • 用根级 ConsumerWidget 根据认证状态选择页面
  • 正确处理会话恢复中的 loading、error、已登录和未登录分支
  • 避免在多个业务页面里重复执行认证跳转

让根组件成为唯一切换点

页面切换本质上是认证状态的派生结果,而不是每个页面各自触发的副作用。根组件订阅 authProvider 后,可以把状态直接映射成界面:

  • loading:显示启动加载页
  • data(null):显示登录页
  • data(user):显示主界面
  • error:显示错误并允许重试

这样登录成功只需要更新 Provider,不需要再调用一次 Navigator.pushReplacement;退出登录也只需要清空认证状态,根组件会自动切回登录页。

认证状态驱动根页面切换流程

下面是一个可直接运行的最小示例。它使用 AuthGate 作为应用首页,由 Provider 状态统一决定实际页面。

dart
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

void main() {
  runApp(const ProviderScope(child: MyApp()));
}

class AppUser {
  const AppUser(this.name);

  final String name;
}

final authProvider =
    AsyncNotifierProvider<AuthController, AppUser?>(AuthController.new);

class AuthController extends AsyncNotifier<AppUser?> {
  @override
  Future<AppUser?> build() async {
    // 模拟启动时恢复本地会话。
    await Future<void>.delayed(const Duration(milliseconds: 500));
    return null;
  }

  Future<void> signIn() async {
    state = const AsyncLoading();
    await Future<void>.delayed(const Duration(milliseconds: 500));
    state = const AsyncData(AppUser('Ada'));
  }

  void signOut() {
    state = const AsyncData(null);
  }
}

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

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(home: AuthGate());
  }
}

class AuthGate extends ConsumerWidget {
  const AuthGate({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final auth = ref.watch(authProvider);

    return auth.when(
      loading: () => const SplashPage(),
      error: (error, stackTrace) => ErrorPage(
        message: error.toString(),
        onRetry: () => ref.invalidate(authProvider),
      ),
      data: (user) {
        return user == null
            ? const LoginPage()
            : HomePage(user: user);
      },
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      body: Center(child: CircularProgressIndicator()),
    );
  }
}

class LoginPage extends ConsumerWidget {
  const LoginPage({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    return Scaffold(
      appBar: AppBar(title: const Text('登录')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            ref.read(authProvider.notifier).signIn();
          },
          child: const Text('登录'),
        ),
      ),
    );
  }
}

class HomePage extends ConsumerWidget {
  const HomePage({required this.user, super.key});

  final AppUser user;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    return Scaffold(
      appBar: AppBar(title: Text('你好,${user.name}')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            ref.read(authProvider.notifier).signOut();
          },
          child: const Text('退出登录'),
        ),
      ),
    );
  }
}

class ErrorPage extends StatelessWidget {
  const ErrorPage({
    required this.message,
    required this.onRetry,
    super.key,
  });

  final String message;
  final VoidCallback onRetry;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text('会话恢复失败:$message'),
            const SizedBox(height: 8),
            ElevatedButton(
              onPressed: onRetry,
              child: const Text('重试'),
            ),
          ],
        ),
      ),
    );
  }
}

预期结果

text
启动应用:先显示加载指示器,随后显示登录页
点击“登录”:短暂进入加载状态,随后自动显示“你好,Ada”的主界面
点击“退出登录”:无需手动导航,自动回到登录页

示例中的 500 毫秒只是模拟异步认证,实际时间可能不同。

为什么不在每个页面里做跳转

在多个页面分别 watch 登录状态,再各自调用 Navigator,容易造成重复跳转、页面栈混乱和竞态。例如登录状态变化时,当前页与后台仍挂载的页面可能同时尝试导航。

AuthGate 采用声明式映射:认证状态是什么,根页面就是什么。业务页面只处理业务,不承担全局认证路由判断。即使应用有十几个页面,登录规则也只有一个入口。

把加载态和未登录态分开

应用启动时,loading 表示“还不知道有没有会话”,而 data(null) 才表示“已经确认没有登录用户”。如果把两者合并,应用可能先闪一下登录页,再跳到主界面。

因此认证入口至少要保留这两个阶段。对于真实后端,还应保留 error 分支,并提供重试或重新登录路径。这样根页面切换既集中,又能完整表达认证生命周期。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让登录状态驱动页面变化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通