跨平台开发 / 系统课时

设计缓存优先读取流程

设计缓存优先读取流程

缓存优先并不是“只读缓存”,而是把首屏速度和数据新鲜度拆成两个阶段:先用本地数据快速渲染,再按策略请求远端,成功后刷新缓存与界面。本节用一个完整示例实现这条链路,并说明空缓存、远端失败和数据更新时的处理顺序。

学习目标

  • 设计“先本地、后远端”的读取顺序
  • 在不阻塞首屏的前提下用远端结果刷新本地数据
  • 正确处理空缓存、请求失败和远端数据未变化三种边界

缓存优先的核心流程

缓存优先通常包含四个动作:读取本地缓存、立即向界面提供可用数据、请求服务器、把新结果写回缓存并再次通知界面。这里真正重要的是两次交付数据:第一次优化等待时间,第二次恢复新鲜度。

缓存优先读取与后台刷新流程

这种流程适合列表、文章、用户资料等“允许短时间陈旧”的数据。如果页面必须拿到最新值才能继续,例如提交支付前确认价格,则不应把缓存优先当成最终判定机制。

实现一个最小缓存优先仓库

下面用 Dart 标准库模拟本地缓存和远端接口。load 会先把缓存交给调用方,然后继续等待远端;远端返回更高版本时写回缓存并再次交付。

dart
import 'dart:async';

class Article {
  final String title;
  final int version;

  const Article(this.title, this.version);
}

class ArticleRepository {
  Article? _localCache = const Article('本地旧标题', 1);

  Future<Article> _fetchRemote() async {
    await Future<void>.delayed(const Duration(milliseconds: 20));
    return const Article('服务器新标题', 2);
  }

  Future<void> load(void Function(Article article, String source) emit) async {
    final cached = _localCache;
    if (cached != null) {
      emit(cached, 'cache');
    }

    try {
      final remote = await _fetchRemote();
      if (cached == null || remote.version != cached.version) {
        _localCache = remote;
        emit(remote, 'server');
      }
    } catch (_) {
      if (cached == null) {
        rethrow;
      }
    }
  }
}

Future<void> main() async {
  final repository = ArticleRepository();

  await repository.load((article, source) {
    print('$source: ${article.title} (v${article.version})');
  });
}

预期输出

text
cache: 本地旧标题 (v1)
server: 服务器新标题 (v2)

示例中的延迟只是为了模拟网络,不代表真实接口耗时。真实 Flutter 项目中,可以把 emit 对接到 ChangeNotifier、Riverpod、Bloc 或其他状态管理方案;本地缓存也可以由 SQLite、Hive、Isar 等实现,但读取顺序与一致性规则不应依赖具体库。

远端返回后怎样更新

远端成功后不要无条件触发整页刷新。先比较版本、更新时间或内容哈希,确认数据确实变化,再执行“写本地缓存 → 更新内存状态”。这样既能避免重复写盘,也能减少无意义的 UI rebuild。

如果远端失败但已有缓存,页面通常继续展示缓存,并用轻量提示表达“刷新失败”;如果本地也没有数据,才进入真正的错误态。这个区别决定了弱网下页面是“仍可用”还是“完全不可用”。

验收缓存优先是否设计正确

可以用三个场景快速验证:有缓存且远端更新时应先显示旧值再刷新;有缓存但远端失败时旧值应保留;无缓存且远端失败时才显示错误。只要这三条成立,缓存就在承担“加速与降级”的职责,而没有越权成为最终真相。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计缓存优先读取流程

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

登录哪都通