跨平台开发 / 系统课时
处理页面切换后的请求状态
处理页面切换后的请求状态
页面发起异步请求后,用户可能在结果返回前离开。合理的处理方式不是让页面继续持有请求状态,而是让请求状态跟随 Provider 生命周期:无人监听时释放状态并尽量取消网络请求,重新进入时再按缓存策略决定是否请求。
学习目标
- 使用
autoDispose让页面级请求在离开页面后自动释放 - 在 Provider 销毁时取消仍在进行的 Dio 请求
- 根据业务需要选择重新请求或短时间保留缓存
让请求状态跟随页面生命周期
页面级详情、搜索结果等状态通常只服务于当前路由。若 Provider 永久存活,用户离开页面后,请求仍可能继续执行,返回的数据也会继续占用缓存。FutureProvider.autoDispose.family 可以让请求与参数绑定,并在最后一个监听者消失后进入销毁流程。

下面是一个完整的页面级请求示例。示例假设 Flutter 项目已安装 flutter_riverpod 与 dio,详情页离开后会释放 Provider,并通过 CancelToken 尝试终止仍在进行的 HTTP 请求。
dart
import 'package:dio/dio.dart';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
final dioProvider = Provider<Dio>((ref) {
final dio = Dio(
BaseOptions(baseUrl: 'https://jsonplaceholder.typicode.com'),
);
ref.onDispose(dio.close);
return dio;
});
final postProvider = FutureProvider.autoDispose.family<Map<String, dynamic>, int>(
(ref, postId) async {
final dio = ref.watch(dioProvider);
final cancelToken = CancelToken();
// 页面不再监听时,停止仍有机会取消的网络请求。
ref.onDispose(() {
if (!cancelToken.isCancelled) {
cancelToken.cancel('detail page disposed');
}
});
final response = await dio.get<Map<String, dynamic>>(
'/posts/$postId',
cancelToken: cancelToken,
);
return response.data!;
},
);
void main() {
runApp(const ProviderScope(child: App()));
}
class App extends StatelessWidget {
const App({super.key});
@override
Widget build(BuildContext context) {
return const MaterialApp(home: HomePage());
}
}
class HomePage extends StatelessWidget {
const HomePage({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('文章列表')),
body: Center(
child: ElevatedButton(
onPressed: () {
Navigator.of(context).push(
MaterialPageRoute(
builder: (_) => const DetailPage(postId: 1),
),
);
},
child: const Text('打开文章 1'),
),
),
);
}
}
class DetailPage extends ConsumerWidget {
const DetailPage({super.key, required this.postId});
final int postId;
@override
Widget build(BuildContext context, WidgetRef ref) {
final post = ref.watch(postProvider(postId));
return Scaffold(
appBar: AppBar(title: Text('文章 $postId')),
body: post.when(
loading: () => const Center(child: CircularProgressIndicator()),
error: (error, stackTrace) => Center(child: Text('加载失败:$error')),
data: (data) => Padding(
padding: const EdgeInsets.all(16),
child: Text(data['title'] as String),
),
),
);
}
}预期结果
text
点击“打开文章 1”后,详情页先显示加载指示器,随后显示文章标题。
若在请求完成前返回上一页,详情页停止监听 postProvider(1),Provider 进入销毁流程并取消仍在执行的 Dio 请求。
再次打开文章 1 时,会创建新的页面级请求并重新显示加载状态。这里不需要在页面的 dispose 中手工修改请求状态。页面只负责 watch,请求的创建、取消和状态释放统一放在 Provider 中,因此不会出现已离开的页面继续维护一份异步状态的问题。
决定重新请求还是保留缓存
autoDispose 最适合“离开后数据可以丢弃”的页面,例如一次性详情、临时筛选结果。如果用户频繁在列表和详情之间切换,而数据一分钟内基本不会变化,可以在请求成功后临时保留 Provider。
下面是片段示例,依赖前面的 dioProvider,并额外导入 dart:async。keepAlive 只在请求成功后执行,因此失败请求仍可在无人监听时正常释放。
dart
import 'dart:async';
final cachedPostProvider =
FutureProvider.autoDispose.family<Map<String, dynamic>, int>(
(ref, postId) async {
final dio = ref.watch(dioProvider);
final response = await dio.get<Map<String, dynamic>>('/posts/$postId');
final link = ref.keepAlive();
final timer = Timer(const Duration(minutes: 1), link.close);
ref.onDispose(timer.cancel);
return response.data!;
},
);预期结果
text
请求成功后,即使暂时离开详情页,结果仍可保留约 1 分钟。
在缓存有效期内重新监听相同 postId 时可以继续使用现有状态;保留时间结束且无人监听后,Provider 可以被释放。缓存时间不是越长越好。商品库存、支付状态等强时效数据通常更适合重新请求;文章详情、静态配置等变化较慢的数据才适合短时间保留。关键是让缓存周期与数据的新鲜度要求匹配,而不是为了减少请求永久保存页面状态。
按自己的节奏,确认真正理解。