跨平台开发 / 系统课时
看懂 Provider 的缓存行为
看懂 Provider 的缓存行为
把 Provider 当成“带依赖追踪的缓存入口”更容易理解它的价值:同一 ProviderScope 内,消费者读取同一个 Provider 时,不会每次都重新执行创建函数;只有依赖变化、被显式失效或作用域销毁后,Riverpod 才需要重新计算。
学习目标
- 理解 Provider 与普通全局变量在生命周期和依赖追踪上的差异
- 验证同一作用域内重复读取会复用缓存结果
- 判断哪些操作会让缓存失效并触发重新计算
缓存发生在 Provider 容器里
Provider 的声明本身只是“如何得到值”的定义,真正的状态和缓存保存在 ProviderContainer 中;在 Flutter 应用里,ProviderScope 会创建并向子树提供这个容器。因此,同一个 Provider 定义放到两个不同容器中,会得到两份彼此独立的缓存。
这与普通全局变量有两个关键区别。第一,Provider 的值有明确作用域,可以随着容器销毁;第二,Provider 会记录“谁依赖了谁”,当上游依赖变化时,只重新计算受影响的下游 Provider,而不是要求业务代码手动维护缓存一致性。

用一次运行验证复用
下面的 Flutter 示例在同一个 Widget 构建过程中连续两次 ref.watch(configProvider)。第一次读取时 Provider 创建函数执行并生成值,第二次读取直接复用同一容器里的缓存。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
int computeCount = 0;
final configProvider = Provider<String>((ref) {
computeCount++;
debugPrint('configProvider 计算次数: $computeCount');
return 'api-v1';
});
void main() {
runApp(
const ProviderScope(
child: MaterialApp(home: CacheDemoPage()),
),
);
}
class CacheDemoPage extends ConsumerWidget {
const CacheDemoPage({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final first = ref.watch(configProvider);
final second = ref.watch(configProvider);
return Scaffold(
body: Center(
child: Text('$first / $second'),
),
);
}
}预期结果
首次启动并构建该页面时,控制台出现一次:
configProvider 计算次数: 1
页面显示:
api-v1 / api-v1在调试模式下发生热重载或框架额外重建时,日志次数可能变化;要观察的是同一份缓存有效期间,重复读取不会为每次读取都重新执行创建函数。
依赖变化会让缓存重新计算
Provider 可以在创建函数中通过 ref.watch(otherProvider) 声明依赖。Riverpod 会记录这条依赖边:上游值变化后,下游 Provider 的旧结果会失效,并在下次需要时按新的依赖值重新计算。这种“缓存 + 依赖追踪”正是普通全局变量不具备的能力。
常见的重新计算来源包括:被监听的上游 Provider 发生变化、代码调用失效 API、Provider 所在容器被销毁后重新创建。若使用自动释放能力,没有监听者时相关状态还可能被清理,之后再次使用时重新创建。
什么时候依赖这份缓存
适合交给 Provider 缓存的通常是可由依赖计算出的共享结果,例如格式化配置、权限组合、筛选后的数据视图或仓库对象。这样多个消费者可以复用同一结果,同时由 Riverpod 负责失效。
不要把 Provider 理解成无限期保存数据的全局单例。需要跨进程持久化的数据仍应写入数据库、文件或安全存储;Provider 更适合管理应用运行期间、受作用域和依赖关系约束的状态。