跨平台开发 / 系统课时

看懂 Provider 的缓存行为

看懂 Provider 的缓存行为

把 Provider 当成“带依赖追踪的缓存入口”更容易理解它的价值:同一 ProviderScope 内,消费者读取同一个 Provider 时,不会每次都重新执行创建函数;只有依赖变化、被显式失效或作用域销毁后,Riverpod 才需要重新计算。

学习目标

  • 理解 Provider 与普通全局变量在生命周期和依赖追踪上的差异
  • 验证同一作用域内重复读取会复用缓存结果
  • 判断哪些操作会让缓存失效并触发重新计算

缓存发生在 Provider 容器里

Provider 的声明本身只是“如何得到值”的定义,真正的状态和缓存保存在 ProviderContainer 中;在 Flutter 应用里,ProviderScope 会创建并向子树提供这个容器。因此,同一个 Provider 定义放到两个不同容器中,会得到两份彼此独立的缓存。

这与普通全局变量有两个关键区别。第一,Provider 的值有明确作用域,可以随着容器销毁;第二,Provider 会记录“谁依赖了谁”,当上游依赖变化时,只重新计算受影响的下游 Provider,而不是要求业务代码手动维护缓存一致性。

Provider 缓存与依赖失效关系

用一次运行验证复用

下面的 Flutter 示例在同一个 Widget 构建过程中连续两次 ref.watch(configProvider)。第一次读取时 Provider 创建函数执行并生成值,第二次读取直接复用同一容器里的缓存。

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

预期结果

text
首次启动并构建该页面时,控制台出现一次:
configProvider 计算次数: 1

页面显示:
api-v1 / api-v1

在调试模式下发生热重载或框架额外重建时,日志次数可能变化;要观察的是同一份缓存有效期间,重复读取不会为每次读取都重新执行创建函数。

依赖变化会让缓存重新计算

Provider 可以在创建函数中通过 ref.watch(otherProvider) 声明依赖。Riverpod 会记录这条依赖边:上游值变化后,下游 Provider 的旧结果会失效,并在下次需要时按新的依赖值重新计算。这种“缓存 + 依赖追踪”正是普通全局变量不具备的能力。

常见的重新计算来源包括:被监听的上游 Provider 发生变化、代码调用失效 API、Provider 所在容器被销毁后重新创建。若使用自动释放能力,没有监听者时相关状态还可能被清理,之后再次使用时重新创建。

什么时候依赖这份缓存

适合交给 Provider 缓存的通常是可由依赖计算出的共享结果,例如格式化配置、权限组合、筛选后的数据视图或仓库对象。这样多个消费者可以复用同一结果,同时由 Riverpod 负责失效。

不要把 Provider 理解成无限期保存数据的全局单例。需要跨进程持久化的数据仍应写入数据库、文件或安全存储;Provider 更适合管理应用运行期间、受作用域和依赖关系约束的状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

看懂 Provider 的缓存行为

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

登录哪都通