跨平台开发 / 系统课时
处理离线状态下的数据读取
处理离线状态下的数据读取
离线读取的关键不是简单“捕获网络异常”,而是把远端、本地缓存和功能可用性放进同一套决策中。完成本节后,你可以让页面在断网时稳定回退到本地数据,并清楚告诉用户哪些操作还能继续、哪些必须等待联网。
学习目标
- 设计“远端优先、本地回退”的读取路径
- 区分可离线读取与必须联网的功能
- 用明确的结果类型驱动页面展示离线状态
把离线读取当成仓储层决策
页面不应该自己判断“有没有网,再决定读哪里”。更稳妥的做法是让 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 应返回明确错误,让页面进入空状态或重试状态,而不是伪造空列表。
因此,离线读取的核心顺序应保持稳定:先获取可信远端数据,失败后尝试缓存,有缓存则降级使用,没有缓存则明确失败。这样既能提升断网可用性,也不会把“没有数据”和“无法获取数据”混为一谈。
按自己的节奏,确认真正理解。