跨平台开发 / 系统课时

设计错误和重试状态

设计错误和重试状态

当 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 显示错误提示和重新加载按钮

设计可恢复的失败体验

错误页面不应该只是告知失败原因,还需要提供明确行动。例如网络失败可以保留“重试”按钮,权限失败可以跳转登录流程,业务异常可以展示客服或帮助入口。

对于局部区域加载失败,不建议替换整个页面。列表中的单个卡片失败、某个组件请求失败,都可以使用局部错误组件,保持其他内容可用。

什么时候不该使用重试按钮

重试不是所有错误的解决方案。如果失败原因是权限不足、参数错误或账号状态异常,连续点击重试只会重复失败。

错误状态设计的目标不是隐藏失败,而是帮助用户完成下一步操作。好的错误反馈应该让用户理解当前状态,并快速恢复到正常流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计错误和重试状态

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

登录哪都通