跨平台开发 / 系统课时

处理页面切换后的请求状态

处理页面切换后的请求状态

页面发起异步请求后,用户可能在结果返回前离开。合理的处理方式不是让页面继续持有请求状态,而是让请求状态跟随 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 可以被释放。

缓存时间不是越长越好。商品库存、支付状态等强时效数据通常更适合重新请求;文章详情、静态配置等变化较慢的数据才适合短时间保留。关键是让缓存周期与数据的新鲜度要求匹配,而不是为了减少请求永久保存页面状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理页面切换后的请求状态

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

登录哪都通