跨平台开发 / 系统课时

处理加载、空数据和错误状态

处理加载、空数据和错误状态

网络页面不会一直处于成功状态,用户等待时需要看到加载反馈,没有数据时需要合理提示,请求失败时需要提供恢复入口。本篇将完善 Flutter 页面常见的 loading、empty、error 和 retry 状态处理方式。

学习目标

  • 理解异步页面中的多状态管理方式
  • 掌握加载、空数据和错误状态的 UI 表达
  • 能够设计支持重试的数据请求流程

网络页面为什么需要多状态

一个接口请求通常存在多个阶段:开始请求、等待响应、获取数据、请求失败。只显示最终数据会导致用户面对空白页面或无响应状态。

常见页面状态包括:

状态 用户看到的内容 触发条件
loading 加载提示 请求正在执行
success 数据列表或详情 请求成功且有数据
empty 空状态提示 请求成功但没有数据
error 错误提示和重试按钮 请求失败

实际开发中,可以使用状态对象统一描述这些情况。

定义页面状态模型

下面示例使用简单状态类表示请求结果:

dart
sealed class ViewState<T> {}

class Loading<T> extends ViewState<T> {}

class Success<T> extends ViewState<T> {
  final T data;

  Success(this.data);
}

class Empty<T> extends ViewState<T> {}

class ErrorState<T> extends ViewState<T> {
  final String message;

  ErrorState(this.message);
}

void main() {
  ViewState<List<String>> state = Success(['Flutter']);

  if (state is Success<List<String>>) {
    print(state.data);
  }
}

预期输出

text
[Flutter]

通过状态对象,界面层只需要根据当前状态选择展示内容,不需要重复判断请求是否完成。

在页面中展示不同状态

Widget 通常根据状态分支渲染不同界面:

dart
Widget buildContent(ViewState<List<String>> state) {
  return switch (state) {
    Loading() => const CircularProgressIndicator(),
    Empty() => const Text('暂无数据'),
    Success(data: final items) => ListView(
        children: items.map(Text.new).toList(),
      ),
    ErrorState(message: final message) => Text(message),
  };
}

预期结果

text
loading 状态显示进度指示器;
empty 状态显示暂无数据;
success 状态显示列表内容;
error 状态显示错误信息。

这种方式比在 Widget 中散落多个布尔变量更容易维护,例如 isLoading、hasError、hasData 同时存在时,很容易产生互相冲突的组合。

设计错误恢复和重试

错误状态不应该只是显示错误文字,用户通常需要再次尝试请求。重试逻辑应该重新执行请求流程,而不是直接修改界面状态。

例如:

dart
Future<void> retry() async {
  state = Loading();

  try {
    final data = await loadItems();
    state = data.isEmpty ? Empty() : Success(data);
  } catch (e) {
    state = ErrorState('加载失败,请稍后重试');
  }
}

预期结果

text
请求开始时进入 Loading;
成功返回数据进入 Success 或 Empty;
异常进入 ErrorState。

页面状态设计的重点是覆盖真实用户路径。加载、空数据和错误并不是异常分支,而是网络应用中的正常情况。将这些状态显式建模,可以让 Flutter 页面行为更稳定,也更容易扩展新的交互状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理加载、空数据和错误状态

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

登录哪都通