跨平台开发 / 系统课时

处理离线状态下的数据读取

处理离线状态下的数据读取

离线读取的关键不是简单“捕获网络异常”,而是把远端、本地缓存和功能可用性放进同一套决策中。完成本节后,你可以让页面在断网时稳定回退到本地数据,并清楚告诉用户哪些操作还能继续、哪些必须等待联网。

学习目标

  • 设计“远端优先、本地回退”的读取路径
  • 区分可离线读取与必须联网的功能
  • 用明确的结果类型驱动页面展示离线状态

把离线读取当成仓储层决策

页面不应该自己判断“有没有网,再决定读哪里”。更稳妥的做法是让 Repository 同时掌握远端数据源和本地数据源:先尝试远端,成功后刷新缓存;远端失败时再读取本地缓存。

这种设计有两个好处。第一,页面只消费统一的数据结果,不需要知道数据来自哪里。第二,网络失败不等于业务失败,只要本地仍有可接受的数据,页面就能继续展示。

离线读取回退流程

用结果类型表达数据来源

下面的可运行 Dart 示例把读取结果分成“远端新数据”“本地缓存”和“不可用”三种状态。示例中的远端调用故意抛出异常,用来模拟断网。

dart
enum DataSource { remote, cache }

class ReadResult<T> {
  final T data;
  final DataSource source;
  const ReadResult(this.data, this.source);
}

class Repository {
  final List<String> _cache = ['cached-a', 'cached-b'];

  Future<List<String>> _fetchRemote() async {
    throw Exception('network unavailable');
  }

  Future<ReadResult<List<String>>> loadItems() async {
    try {
      final remote = await _fetchRemote();
      _cache
        ..clear()
        ..addAll(remote);
      return ReadResult(remote, DataSource.remote);
    } catch (_) {
      if (_cache.isNotEmpty) {
        return ReadResult(List.unmodifiable(_cache), DataSource.cache);
      }
      rethrow;
    }
  }
}

Future<void> main() async {
  final result = await Repository().loadItems();
  print('${result.source}: ${result.data.join(',')}');
}

预期输出

text
DataSource.cache: cached-a,cached-b

真实项目里不要把所有异常都无条件吞掉。可以把超时、DNS 失败、连接失败视为可回退场景,而认证失效、数据格式错误等问题应单独处理,否则旧缓存可能掩盖真正的业务错误。

明确离线时哪些功能仍可用

离线页面通常不是“全部可用”或“全部禁用”两种极端。更合理的是按操作是否依赖服务器确认来划分。

功能 离线时建议 原因
浏览已缓存列表 允许 不需要产生新服务器状态
查看已缓存详情 允许 数据可从本地读取
下单、支付、提交审核 禁止或排队 需要服务器确认最终结果
本地草稿编辑 允许 可先保存本地,联网后再同步

页面应该显式展示“当前内容来自缓存”之类的状态,而不是让用户误以为数据仍是最新。若某个按钮必须联网,可以在点击前直接说明原因,避免用户完成一长串输入后才失败。

没有缓存时要正常失败

离线回退成立的前提是本地确实有可用数据。首次启动、缓存被清理或数据已过期且不可接受时,Repository 应返回明确错误,让页面进入空状态或重试状态,而不是伪造空列表。

因此,离线读取的核心顺序应保持稳定:先获取可信远端数据,失败后尝试缓存,有缓存则降级使用,没有缓存则明确失败。这样既能提升断网可用性,也不会把“没有数据”和“无法获取数据”混为一谈。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理离线状态下的数据读取

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

登录哪都通