跨平台开发 / 系统课时
设计网络优先读取流程
设计网络优先读取流程
当页面既有接口数据又有本地缓存时,网络优先策略的目标是先争取最新结果:请求成功就返回网络数据并覆盖缓存;请求失败时再尝试缓存,让用户在弱网或离线场景仍有可用内容。
学习目标
- 设计“先网络、后缓存兜底”的读取顺序
- 在网络成功后同步刷新本地缓存
- 区分网络失败、缓存命中和彻底失败三种结果
网络优先策略解决什么问题
网络优先适合“新鲜度比首屏速度更重要,但允许失败时降级”的数据,例如订单状态、用户资料和远端配置。它与缓存优先最大的区别,是正常路径始终先访问服务端,因此不会因为旧缓存存在就跳过最新数据。
一次完整读取通常涉及页面、Repository、远端数据源和本地缓存四个角色。Repository 负责控制顺序,页面只接收最终结果,不需要知道数据来自哪里。

用 Repository 固定读取顺序
下面用一个可直接运行的 Dart 示例模拟网络请求和内存缓存。真实 Flutter 项目中,可以把 RemoteDataSource 换成 http、Dio 等实现,把 LocalCache 换成 SharedPreferences、Hive、SQLite 或文件存储。
class Article {
final String id;
final String title;
const Article(this.id, this.title);
@override
String toString() => '$id:$title';
}
class RemoteDataSource {
final bool shouldFail;
RemoteDataSource({this.shouldFail = false});
Future<Article> fetchArticle() async {
if (shouldFail) {
throw Exception('network unavailable');
}
return const Article('42', 'Latest from server');
}
}
class LocalCache {
Article? _value;
Future<Article?> read() async => _value;
Future<void> write(Article article) async {
_value = article;
}
}
class ArticleRepository {
final RemoteDataSource remote;
final LocalCache cache;
ArticleRepository(this.remote, this.cache);
Future<Article> getArticle() async {
try {
final fresh = await remote.fetchArticle();
// 远端成功后先刷新缓存,后续离线读取才拿得到最新成功结果。
await cache.write(fresh);
return fresh;
} catch (_) {
final cached = await cache.read();
if (cached != null) {
return cached;
}
// 网络和缓存都不可用时,把失败交给上层统一展示。
rethrow;
}
}
}
Future<void> main() async {
final cache = LocalCache();
final online = ArticleRepository(
RemoteDataSource(),
cache,
);
print(await online.getArticle());
final offline = ArticleRepository(
RemoteDataSource(shouldFail: true),
cache,
);
print(await offline.getArticle());
}预期输出:
42:Latest from server
42:Latest from server第一行来自网络,并同时写入缓存;第二次模拟断网,请求失败后读取刚才保存的缓存,因此页面仍得到同一条数据。
处理三个关键边界
网络失败不应该自动等同于“使用缓存”。只有缓存确实存在且可接受时才能降级,否则应继续抛错,让 UI 展示空态、错误页或重试入口。
缓存写入失败也要提前决定策略。多数读取场景中,远端数据已经成功拿到时,可以仍然把最新数据返回给页面,同时记录缓存写入异常;如果业务要求“服务端和本地必须一致”,才把缓存写入失败视为整个操作失败。
还要避免在 Widget 中同时编写网络请求和缓存判断。把顺序集中在 Repository 后,测试时可以分别模拟远端成功、远端失败但缓存命中、两边都失败,逻辑更稳定。
什么时候适合网络优先
网络优先适合数据变化频繁、用户希望尽量看到最新值,同时又允许在异常时读取旧数据的页面。如果首屏必须极快,或者数据长时间不变化,更适合缓存优先后后台刷新;如果旧数据可能造成错误决策,例如支付状态或一次性验证码,则应禁止缓存兜底。
设计这条链路时,核心不是“加一个缓存”,而是明确网络成功、网络失败和缓存缺失时各自该返回什么结果,并让这一规则只存在于数据层。