跨平台开发 / 系统课时
管理登录用户和会话状态
管理登录用户和会话状态
登录状态不应散落在各个页面自己的变量里。本课把“当前用户是谁、是否正在恢复会话、怎样登录和退出”集中到一个 Riverpod AsyncNotifier 中,让首页、个人页等多个页面都读取同一份认证状态,并在状态变化时自动刷新。
学习目标
- 用
AsyncNotifierProvider建立可异步初始化的认证状态 - 在多个页面通过
ref.watch读取同一个当前用户 - 区分界面订阅状态与按钮事件触发状态修改的写法
把认证状态收口到一个 Provider
认证状态通常包含三类结果:正在加载、已登录用户、未登录。AsyncValue<AppUser?> 正好可以表达这三种情况:loading 表示正在恢复会话,data(user) 表示已登录,data(null) 表示没有会话,error 则保留初始化或登录失败。
登录、退出属于会改变状态的业务动作,因此放进 AsyncNotifier,页面只负责读取状态和触发方法。这样不会出现首页保存一份 user、个人页又保存一份 user 的同步问题。

下面示例用一个内存中的 AuthRepository 模拟会话恢复、登录和退出。把它保存为 lib/main.dart,并确保项目已经安装 flutter_riverpod。
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('退出登录'),
),
],
);
},
),
);
}
}预期结果
首次启动:
首页显示“登录为 Ada”按钮
个人页显示“个人页:未登录”
点击登录后:
首页显示“首页:你好,Ada”
个人页同步显示“个人页:Ada (u-001)”
点击退出登录后:
两个区域同时回到未登录状态实际异步耗时会因后端请求而不同;示例中的延迟只用于模拟网络与会话恢复。
页面读取与事件修改要分开
界面需要随着用户变化而刷新时,用 ref.watch(authProvider)。登录或退出按钮只是在事件发生时调用方法,不需要订阅 notifier,所以使用 ref.read(authProvider.notifier)。
这条边界很重要:读取界面状态用 watch,触发一次业务动作通常用 read。如果多个页面都遵循这个模式,它们会自然共享同一份用户状态,而不是互相传递用户对象。
会话恢复为什么放在 build
AuthController.build() 是认证状态的初始化入口。真实项目里可以在这里读取安全存储中的 token,再调用后端查询当前用户。初始化未完成前 Provider 保持异步加载语义,页面不会误把“尚未恢复完成”当成“明确未登录”。
当认证状态被集中到一个 Provider 后,任何需要用户信息的页面都只依赖 authProvider。用户一旦登录、退出或会话恢复失败,所有订阅者都会依据同一个状态源更新。