跨平台开发 / 系统课时
设计错误和重试状态
设计错误和重试状态
当 Flutter 页面依赖网络请求、权限校验或远程服务时,失败是必须处理的正常状态。本节将设计清晰的错误反馈,让用户知道发生了什么,并提供可恢复的操作路径。
学习目标
- 理解不同错误类型对应的 UI 反馈方式
- 使用 Flutter 组件构建错误提示和重试交互
- 设计避免用户困惑的失败状态页面
区分错误类型和展示策略
错误状态不能简单统一显示“加载失败”。网络断开、权限不足和服务异常虽然都会导致数据无法展示,但用户下一步需要执行的操作不同。
常见分类如下:
| 错误类型 | 用户需要知道的信息 | 推荐操作 |
|---|---|---|
| 网络不可用 | 当前无法连接服务 | 检查网络后重试 |
| 权限不足 | 当前账号无访问权限 | 登录或申请权限 |
| 服务异常 | 服务暂时不可用 | 稍后重试 |
设计错误页面时,应优先回答三个问题:发生了什么、用户能做什么、如何恢复。
使用状态驱动错误 UI
页面通常会根据状态切换内容,而不是在任意位置直接显示错误文本。可以使用枚举管理加载、成功和失败状态。
dart
import 'package:flutter/material.dart';
enum LoadState { loading, success, error }
class ErrorPage extends StatelessWidget {
const ErrorPage({super.key, required this.state});
final LoadState state;
@override
Widget build(BuildContext context) {
switch (state) {
case LoadState.loading:
return const Center(child: CircularProgressIndicator());
case LoadState.success:
return const Center(child: Text('内容加载完成'));
case LoadState.error:
return Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
const Icon(Icons.error_outline, size: 48),
const SizedBox(height: 12),
const Text('数据加载失败'),
ElevatedButton(
onPressed: () {
// 实际项目中这里触发重新请求
},
child: const Text('重新加载'),
),
],
),
);
}
}
}预期结果
text
页面根据 LoadState 显示不同内容:
loading 显示加载指示器
success 显示业务内容
error 显示错误提示和重新加载按钮设计可恢复的失败体验
错误页面不应该只是告知失败原因,还需要提供明确行动。例如网络失败可以保留“重试”按钮,权限失败可以跳转登录流程,业务异常可以展示客服或帮助入口。
对于局部区域加载失败,不建议替换整个页面。列表中的单个卡片失败、某个组件请求失败,都可以使用局部错误组件,保持其他内容可用。
什么时候不该使用重试按钮
重试不是所有错误的解决方案。如果失败原因是权限不足、参数错误或账号状态异常,连续点击重试只会重复失败。
错误状态设计的目标不是隐藏失败,而是帮助用户完成下一步操作。好的错误反馈应该让用户理解当前状态,并快速恢复到正常流程。
按自己的节奏,确认真正理解。