跨平台开发 / 系统课时
设计重试和错误提示策略
设计重试和错误提示策略
网络请求失败并不都代表需要再次发送请求。本篇将建立 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、服务端幂等设计或用户确认机制,而不是直接增加重试次数。好的重试策略应该降低临时故障影响,同时避免制造新的业务问题。
按自己的节奏,确认真正理解。