跨平台开发 / 系统课时

管理登录用户和会话状态

管理登录用户和会话状态

登录状态不应散落在各个页面自己的变量里。本课把“当前用户是谁、是否正在恢复会话、怎样登录和退出”集中到一个 Riverpod AsyncNotifier 中,让首页、个人页等多个页面都读取同一份认证状态,并在状态变化时自动刷新。

学习目标

  • 用 AsyncNotifierProvider 建立可异步初始化的认证状态
  • 在多个页面通过 ref.watch 读取同一个当前用户
  • 区分界面订阅状态与按钮事件触发状态修改的写法

把认证状态收口到一个 Provider

认证状态通常包含三类结果:正在加载、已登录用户、未登录。AsyncValue<AppUser?> 正好可以表达这三种情况:loading 表示正在恢复会话,data(user) 表示已登录,data(null) 表示没有会话,error 则保留初始化或登录失败。

登录、退出属于会改变状态的业务动作,因此放进 AsyncNotifier,页面只负责读取状态和触发方法。这样不会出现首页保存一份 user、个人页又保存一份 user 的同步问题。

认证状态 Provider 与多个页面共享同一会话

下面示例用一个内存中的 AuthRepository 模拟会话恢复、登录和退出。把它保存为 lib/main.dart,并确保项目已经安装 flutter_riverpod。

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

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

class AppUser {
  const AppUser({required this.id, required this.name});

  final String id;
  final String name;
}

class AuthRepository {
  AppUser? _currentUser;

  Future<AppUser?> restoreSession() async {
    await Future<void>.delayed(const Duration(milliseconds: 300));
    return _currentUser;
  }

  Future<AppUser> signIn(String name) async {
    await Future<void>.delayed(const Duration(milliseconds: 300));
    return _currentUser = AppUser(id: 'u-001', name: name);
  }

  Future<void> signOut() async {
    await Future<void>.delayed(const Duration(milliseconds: 200));
    _currentUser = null;
  }
}

final authRepositoryProvider = Provider<AuthRepository>((ref) {
  return AuthRepository();
});

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

class AuthController extends AsyncNotifier<AppUser?> {
  @override
  Future<AppUser?> build() {
    return ref.read(authRepositoryProvider).restoreSession();
  }

  Future<void> signIn(String name) async {
    state = const AsyncLoading();
    state = await AsyncValue.guard(
      () => ref.read(authRepositoryProvider).signIn(name),
    );
  }

  Future<void> signOut() async {
    state = const AsyncLoading();
    await ref.read(authRepositoryProvider).signOut();
    state = const AsyncData(null);
  }
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Session demo')),
        body: const Column(
          children: [
            Expanded(child: HomePanel()),
            Divider(),
            Expanded(child: ProfilePanel()),
          ],
        ),
      ),
    );
  }
}

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

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

    return Center(
      child: auth.when(
        loading: () => const CircularProgressIndicator(),
        error: (error, stackTrace) => Text('登录失败:$error'),
        data: (user) {
          if (user == null) {
            return ElevatedButton(
              onPressed: () {
                ref.read(authProvider.notifier).signIn('Ada');
              },
              child: const Text('登录为 Ada'),
            );
          }
          return Text('首页:你好,${user.name}');
        },
      ),
    );
  }
}

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

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

    return Center(
      child: auth.when(
        loading: () => const Text('正在读取会话…'),
        error: (error, stackTrace) => Text('无法读取用户:$error'),
        data: (user) {
          if (user == null) {
            return const Text('个人页:未登录');
          }
          return Column(
            mainAxisSize: MainAxisSize.min,
            children: [
              Text('个人页:${user.name} (${user.id})'),
              const SizedBox(height: 8),
              ElevatedButton(
                onPressed: () {
                  ref.read(authProvider.notifier).signOut();
                },
                child: const Text('退出登录'),
              ),
            ],
          );
        },
      ),
    );
  }
}

预期结果

text
首次启动:
首页显示“登录为 Ada”按钮
个人页显示“个人页:未登录”

点击登录后:
首页显示“首页:你好,Ada”
个人页同步显示“个人页:Ada (u-001)”

点击退出登录后:
两个区域同时回到未登录状态

实际异步耗时会因后端请求而不同;示例中的延迟只用于模拟网络与会话恢复。

页面读取与事件修改要分开

界面需要随着用户变化而刷新时,用 ref.watch(authProvider)。登录或退出按钮只是在事件发生时调用方法,不需要订阅 notifier,所以使用 ref.read(authProvider.notifier)。

这条边界很重要:读取界面状态用 watch,触发一次业务动作通常用 read。如果多个页面都遵循这个模式,它们会自然共享同一份用户状态,而不是互相传递用户对象。

会话恢复为什么放在 build

AuthController.build() 是认证状态的初始化入口。真实项目里可以在这里读取安全存储中的 token,再调用后端查询当前用户。初始化未完成前 Provider 保持异步加载语义,页面不会误把“尚未恢复完成”当成“明确未登录”。

当认证状态被集中到一个 Provider 后,任何需要用户信息的页面都只依赖 authProvider。用户一旦登录、退出或会话恢复失败,所有订阅者都会依据同一个状态源更新。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理登录用户和会话状态

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

登录哪都通