跨平台开发 / 系统课时

设计网络优先读取流程

设计网络优先读取流程

当页面既有接口数据又有本地缓存时,网络优先策略的目标是先争取最新结果:请求成功就返回网络数据并覆盖缓存;请求失败时再尝试缓存,让用户在弱网或离线场景仍有可用内容。

学习目标

  • 设计“先网络、后缓存兜底”的读取顺序
  • 在网络成功后同步刷新本地缓存
  • 区分网络失败、缓存命中和彻底失败三种结果

网络优先策略解决什么问题

网络优先适合“新鲜度比首屏速度更重要,但允许失败时降级”的数据,例如订单状态、用户资料和远端配置。它与缓存优先最大的区别,是正常路径始终先访问服务端,因此不会因为旧缓存存在就跳过最新数据。

一次完整读取通常涉及页面、Repository、远端数据源和本地缓存四个角色。Repository 负责控制顺序,页面只接收最终结果,不需要知道数据来自哪里。

网络优先读取流程

用 Repository 固定读取顺序

下面用一个可直接运行的 Dart 示例模拟网络请求和内存缓存。真实 Flutter 项目中,可以把 RemoteDataSource 换成 http、Dio 等实现,把 LocalCache 换成 SharedPreferences、Hive、SQLite 或文件存储。

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

预期输出:

text
42:Latest from server
42:Latest from server

第一行来自网络,并同时写入缓存;第二次模拟断网,请求失败后读取刚才保存的缓存,因此页面仍得到同一条数据。

处理三个关键边界

网络失败不应该自动等同于“使用缓存”。只有缓存确实存在且可接受时才能降级,否则应继续抛错,让 UI 展示空态、错误页或重试入口。

缓存写入失败也要提前决定策略。多数读取场景中,远端数据已经成功拿到时,可以仍然把最新数据返回给页面,同时记录缓存写入异常;如果业务要求“服务端和本地必须一致”,才把缓存写入失败视为整个操作失败。

还要避免在 Widget 中同时编写网络请求和缓存判断。把顺序集中在 Repository 后,测试时可以分别模拟远端成功、远端失败但缓存命中、两边都失败,逻辑更稳定。

什么时候适合网络优先

网络优先适合数据变化频繁、用户希望尽量看到最新值,同时又允许在异常时读取旧数据的页面。如果首屏必须极快,或者数据长时间不变化,更适合缓存优先后后台刷新;如果旧数据可能造成错误决策,例如支付状态或一次性验证码,则应禁止缓存兜底。

设计这条链路时,核心不是“加一个缓存”,而是明确网络成功、网络失败和缓存缺失时各自该返回什么结果,并让这一规则只存在于数据层。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计网络优先读取流程

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

登录哪都通