跨平台开发 / 系统课时

用 invalidate 主动作废缓存

用 invalidate 主动作废缓存

当应用中的数据已经发生变化,但 Riverpod 仍保留旧 Provider 状态时,需要主动让缓存失效。本篇将学习如何使用 invalidate 标记 Provider 重新计算,并掌握它与普通读取行为之间的关系。

学习目标

  • 理解 invalidate 如何标记 Provider 状态失效
  • 掌握在数据修改后触发重新计算的常见方式
  • 能根据场景选择 invalidate 而不是手动维护缓存

invalidate 的作用机制

Riverpod 中的 Provider 会根据自身生命周期保存计算结果。当一个 Provider 依赖网络请求、数据库查询或其他外部数据源时,缓存可以减少重复计算,但数据变化后旧缓存可能已经不再正确。

invalidate 的作用不是立即执行 Provider,而是告诉 Riverpod 当前状态已经无效。等到下一次有组件读取该 Provider 时,Riverpod 会重新创建状态并执行对应逻辑。

这种行为适合“数据已经改变,下一次展示时需要最新结果”的场景。

在数据修改后让 Provider 重新计算

下面示例使用 Riverpod 的 NotifierProvider 管理用户列表。当新增用户后,通过 ref.invalidate 让列表数据重新获取。

dart
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);
  }
}

预期结果

text
调用 addUser 后,usersProvider 当前缓存被标记为失效。
下一次 Widget 读取 usersProvider 时,会重新执行 Provider 创建逻辑。

invalidate 与 refresh 的区别

两者都可以触发数据更新,但执行时机不同。

方法 行为 适用场景
invalidate 标记失效,等待下一次读取时重新计算 数据变化后延迟刷新
refresh 立即重新执行 Provider 并返回新结果 用户主动点击刷新

例如后台同步完成后,用户暂时没有打开页面,可以使用 invalidate 避免无意义请求。用户点击“刷新”按钮时,则更适合使用 refresh。

使用 invalidate 时的注意点

invalidate 不会替你修改真实数据源。如果接口、数据库中的数据没有变化,只调用 invalidate 仍然会得到相同结果。

另外,频繁 invalidate 大量 Provider 会导致额外请求和状态重建,应优先让状态依赖关系自然驱动更新。对于多个页面共享的数据,通常应该失效最接近数据源的 Provider,而不是所有相关页面状态。

在实际项目中,invalidate 更像缓存协调工具:负责告诉 Riverpod “已有结果不能继续相信”,而不是负责执行数据修改本身。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 invalidate 主动作废缓存

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

登录哪都通