跨平台开发 / 系统课时

设计重试和错误提示策略

设计重试和错误提示策略

网络请求失败并不都代表需要再次发送请求。本篇将建立 Flutter 应用中的错误处理策略,根据错误类型决定是否重试,并设计用户能理解的提示方式,避免无差别弹窗影响体验。

学习目标

  • 理解网络错误分类与重试边界。
  • 使用统一策略处理请求重试和失败提示。
  • 编写可维护的错误处理逻辑。

区分可重试错误和不可重试错误

重试的核心不是“失败就再试”,而是判断失败是否可能因为临时因素导致。网络超时、连接中断、服务端临时不可用通常可以考虑重试,而参数错误、权限不足等问题重复请求不会改变结果。

常见判断方式如下:

错误类型 是否建议重试 原因
网络连接失败 是 用户网络可能短暂恢复
请求超时 是 服务可能暂时繁忙
HTTP 500 谨慎 服务端可能正在恢复
HTTP 401 否 需要重新认证
HTTP 403 否 权限不足
HTTP 400 否 请求参数错误

使用指数退避控制重试频率

连续快速重试会增加服务器压力,也可能让移动端耗电增加。实际应用通常采用指数退避,让每次失败后的等待时间逐渐增加。

例如第一次失败等待 1 秒,第二次等待 2 秒,第三次等待 4 秒,并限制最大等待时间。

下面是一个简单的 Dart 重试函数示例,展示如何只对指定异常执行有限次数重试。

dart
import 'dart:async';

Future<T> retryRequest<T>(
  Future<T> Function() request, {
  int maxAttempts = 3,
}) async {
  for (var attempt = 1; attempt <= maxAttempts; attempt++) {
    try {
      return await request();
    } on TimeoutException {
      // 超时属于临时错误,可以进入下一次尝试。
      if (attempt == maxAttempts) rethrow;
      await Future.delayed(Duration(seconds: attempt));
    }
  }
  throw StateError('request failed');
}

预期结果

text
第一次请求超时后等待 1 秒再次尝试。
第二次请求超时后等待 2 秒再次尝试。
达到最大次数后抛出异常。

设计用户可理解的错误提示

错误提示应该帮助用户采取行动,而不是直接展示技术异常。例如接口超时可以提示“网络较慢,请稍后重试”,登录过期应该引导用户重新登录。

应用中通常将技术异常转换为业务提示:

dart
String errorMessage(Object error) {
  if (error is TimeoutException) {
    return '网络响应较慢,请稍后重试';
  }
  return '请求失败,请检查网络后重试';
}

预期结果

text
TimeoutException 显示“网络响应较慢,请稍后重试”。
其他未知错误显示通用失败提示。

什么时候不应该自动重试

涉及支付、订单提交、数据写入等操作时,需要特别谨慎。重复发送可能导致业务重复执行,即使接口返回失败,也不能简单认为服务端没有处理成功。

对于这类请求,应优先使用请求唯一 ID、服务端幂等设计或用户确认机制,而不是直接增加重试次数。好的重试策略应该降低临时故障影响,同时避免制造新的业务问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计重试和错误提示策略

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

登录哪都通