跨平台开发 / 系统课时
设计缓存优先读取流程
设计缓存优先读取流程
缓存优先并不是“只读缓存”,而是把首屏速度和数据新鲜度拆成两个阶段:先用本地数据快速渲染,再按策略请求远端,成功后刷新缓存与界面。本节用一个完整示例实现这条链路,并说明空缓存、远端失败和数据更新时的处理顺序。
学习目标
- 设计“先本地、后远端”的读取顺序
- 在不阻塞首屏的前提下用远端结果刷新本地数据
- 正确处理空缓存、请求失败和远端数据未变化三种边界
缓存优先的核心流程
缓存优先通常包含四个动作:读取本地缓存、立即向界面提供可用数据、请求服务器、把新结果写回缓存并再次通知界面。这里真正重要的是两次交付数据:第一次优化等待时间,第二次恢复新鲜度。

这种流程适合列表、文章、用户资料等“允许短时间陈旧”的数据。如果页面必须拿到最新值才能继续,例如提交支付前确认价格,则不应把缓存优先当成最终判定机制。
实现一个最小缓存优先仓库
下面用 Dart 标准库模拟本地缓存和远端接口。load 会先把缓存交给调用方,然后继续等待远端;远端返回更高版本时写回缓存并再次交付。
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})');
});
}预期输出
cache: 本地旧标题 (v1)
server: 服务器新标题 (v2)示例中的延迟只是为了模拟网络,不代表真实接口耗时。真实 Flutter 项目中,可以把 emit 对接到 ChangeNotifier、Riverpod、Bloc 或其他状态管理方案;本地缓存也可以由 SQLite、Hive、Isar 等实现,但读取顺序与一致性规则不应依赖具体库。
远端返回后怎样更新
远端成功后不要无条件触发整页刷新。先比较版本、更新时间或内容哈希,确认数据确实变化,再执行“写本地缓存 → 更新内存状态”。这样既能避免重复写盘,也能减少无意义的 UI rebuild。
如果远端失败但已有缓存,页面通常继续展示缓存,并用轻量提示表达“刷新失败”;如果本地也没有数据,才进入真正的错误态。这个区别决定了弱网下页面是“仍可用”还是“完全不可用”。
验收缓存优先是否设计正确
可以用三个场景快速验证:有缓存且远端更新时应先显示旧值再刷新;有缓存但远端失败时旧值应保留;无缓存且远端失败时才显示错误。只要这三条成立,缓存就在承担“加速与降级”的职责,而没有越权成为最终真相。