跨平台开发 / 系统课时

用 refresh 重新获取当前数据

用 refresh 重新获取当前数据

用户点击刷新按钮、页面重新进入或业务操作完成后,应用经常需要立即获取最新数据。Riverpod 提供的 refresh 可以主动重新执行 Provider,并直接返回新的状态结果。

学习目标

  • 理解 refresh 与 invalidate 的执行时机差异
  • 掌握使用 refresh 实现主动刷新
  • 了解 refresh 在异步 Provider 中的返回行为

refresh 的工作方式

refresh 会先让目标 Provider 失效,然后立即重新创建该 Provider 的状态。因此它与 invalidate 最大的区别是执行时机:

  • invalidate 等待下一次读取。
  • refresh 当前调用位置立即触发重新计算。

当界面中存在明确的刷新动作,例如下拉刷新、点击重试按钮、提交表单后更新列表,refresh 通常更符合用户预期。

使用 refresh 重新加载数据

下面示例展示在按钮点击时重新请求远程数据。refresh 返回新的 Provider 状态,可以继续等待异步结果。

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

final profileProvider = FutureProvider<Map<String, String>>((ref) async {
  // 实际项目中这里通常请求 HTTP 接口
  return {'name': 'Alice', 'level': '3'};
});

Future<void> reloadProfile(WidgetRef ref) async {
  // 立即重新执行 profileProvider
  final result = await ref.refresh(profileProvider.future);

  print(result['name']);
}

预期输出

text
Alice

在界面交互中使用 refresh

常见刷新流程是:用户触发操作,调用 refresh,界面等待新的 AsyncValue 状态,然后根据 loading、data 或 error 展示不同内容。

例如列表页中,刷新按钮只需要负责触发重新加载,不需要自己维护一个 loading 标记,因为 Provider 本身已经包含异步状态。

dart
ref.refresh(usersProvider);

预期结果

text
usersProvider 立即重新执行。
界面监听到新的 AsyncValue 后更新显示状态。

refresh 的使用边界

refresh 适合主动刷新,不适合替代正常状态管理。如果每次页面构建都调用 refresh,会造成重复请求和性能问题。

对于写操作后的数据同步,需要根据场景选择:

场景 推荐方式
用户点击刷新按钮 refresh
后台数据变化,等待下次访问更新 invalidate
本地状态直接修改 更新对应 Notifier 状态

理解 refresh 的关键是把它看成一次主动重新计算请求,而不是简单清空缓存。它解决的是“现在就需要最新结果”的问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 refresh 重新获取当前数据

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

登录哪都通