跨平台开发 / 系统课时
让登录状态驱动页面变化
让登录状态驱动页面变化
如果每个页面都写一次“未登录就跳登录页”,导航逻辑会迅速分散。本课把认证状态提升到应用入口,由一个根组件统一决定显示登录页、加载页还是主界面;子页面不再重复判断登录状态。
学习目标
- 用根级
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 分支,并提供重试或重新登录路径。这样根页面切换既集中,又能完整表达认证生命周期。
按自己的节奏,确认真正理解。