跨平台开发 / 系统课时
用 invalidate 主动作废缓存
用 invalidate 主动作废缓存
当应用中的数据已经发生变化,但 Riverpod 仍保留旧 Provider 状态时,需要主动让缓存失效。本篇将学习如何使用 invalidate 标记 Provider 重新计算,并掌握它与普通读取行为之间的关系。
学习目标
- 理解 invalidate 如何标记 Provider 状态失效
- 掌握在数据修改后触发重新计算的常见方式
- 能根据场景选择 invalidate 而不是手动维护缓存
invalidate 的作用机制
Riverpod 中的 Provider 会根据自身生命周期保存计算结果。当一个 Provider 依赖网络请求、数据库查询或其他外部数据源时,缓存可以减少重复计算,但数据变化后旧缓存可能已经不再正确。
invalidate 的作用不是立即执行 Provider,而是告诉 Riverpod 当前状态已经无效。等到下一次有组件读取该 Provider 时,Riverpod 会重新创建状态并执行对应逻辑。
这种行为适合“数据已经改变,下一次展示时需要最新结果”的场景。
在数据修改后让 Provider 重新计算
下面示例使用 Riverpod 的 NotifierProvider 管理用户列表。当新增用户后,通过 ref.invalidate 让列表数据重新获取。
import 'package:flutter_riverpod/flutter_riverpod.dart';
final usersProvider = FutureProvider<List<String>>((ref) async {
// 模拟从接口读取最新用户数据
return ['Alice', 'Bob'];
});
class UserService {
UserService(this.ref);
final Ref ref;
Future<void> addUser(String name) async {
// 实际项目中这里通常调用接口或数据库写入
await Future<void>.delayed(const Duration(milliseconds: 300));
// 数据源变化后,让下一次读取重新获取数据
ref.invalidate(usersProvider);
}
}预期结果
调用 addUser 后,usersProvider 当前缓存被标记为失效。
下一次 Widget 读取 usersProvider 时,会重新执行 Provider 创建逻辑。invalidate 与 refresh 的区别
两者都可以触发数据更新,但执行时机不同。
| 方法 | 行为 | 适用场景 |
|---|---|---|
| invalidate | 标记失效,等待下一次读取时重新计算 | 数据变化后延迟刷新 |
| refresh | 立即重新执行 Provider 并返回新结果 | 用户主动点击刷新 |
例如后台同步完成后,用户暂时没有打开页面,可以使用 invalidate 避免无意义请求。用户点击“刷新”按钮时,则更适合使用 refresh。
使用 invalidate 时的注意点
invalidate 不会替你修改真实数据源。如果接口、数据库中的数据没有变化,只调用 invalidate 仍然会得到相同结果。
另外,频繁 invalidate 大量 Provider 会导致额外请求和状态重建,应优先让状态依赖关系自然驱动更新。对于多个页面共享的数据,通常应该失效最接近数据源的 Provider,而不是所有相关页面状态。
在实际项目中,invalidate 更像缓存协调工具:负责告诉 Riverpod “已有结果不能继续相信”,而不是负责执行数据修改本身。