跨平台开发 / 系统课时
区分网络异常和业务异常
区分网络异常和业务异常
本篇解决 Flutter 请求失败后无法准确判断原因的问题。通过区分网络层异常、HTTP 协议异常和业务返回异常,可以设计更可靠的错误提示、重试策略和日志定位方式。
学习目标
- 理解网络异常、HTTP 异常和业务异常的区别。
- 掌握 Flutter 接口调用中常见错误的分类方式。
- 能够根据异常类型设计合理的处理流程。
三类异常的职责边界
一次 API 请求从客户端发出到业务处理完成,会经过多个层次。错误可能发生在连接阶段,也可能发生在服务器响应阶段,还可能是服务器正常返回但业务条件不满足。
网络异常表示请求没有正常完成通信,例如 DNS 失败、断网、连接超时。这类问题通常无法获得有效业务响应。
HTTP 异常表示服务器已经收到请求并返回响应,但状态码表示请求失败,例如 404、401、500。此时客户端可以读取响应信息,但需要按照 HTTP 语义处理。
业务异常表示 HTTP 请求成功,状态码通常为 200,但响应数据中的业务字段表示操作失败。例如登录接口返回账号不存在、余额不足等情况。
| 类型 | 判断位置 | 示例 | 常见处理 |
|---|---|---|---|
| 网络异常 | 请求通信阶段 | 超时、无网络 | 提示网络问题、允许重试 |
| HTTP 异常 | HTTP 状态码 | 401、500 | 根据状态码处理 |
| 业务异常 | 响应数据字段 | code != 0 | 展示业务提示 |
在 Flutter 中建立异常分层
使用网络库时,不应该把所有失败都转换成“请求失败”。不同异常代表不同解决路径。
例如 Dio 请求可以先捕获传输异常,再检查 HTTP 响应,最后判断业务字段:
dart
import 'package:dio/dio.dart';
class ApiException implements Exception {
final String message;
ApiException(this.message);
}
void handleResponse(Response response) {
// HTTP 成功,但业务结果失败时进入这里
final data = response.data as Map<String, dynamic>;
if (data['code'] != 0) {
throw ApiException(data['message'] ?? '业务处理失败');
}
}
Future<void> requestExample(Dio dio) async {
try {
final response = await dio.get('/user/profile');
handleResponse(response);
} on DioException catch (e) {
// DioException 代表网络或 HTTP 请求过程异常
print('网络请求异常: ${e.type}');
} on ApiException catch (e) {
print('业务异常: ${e.message}');
}
}预期输出
text
网络请求异常: connectionTimeout或者:
text
业务异常: 账号不存在实际项目中通常会在数据层完成异常转换,让页面层只处理统一后的错误类型,避免每个页面重复判断。
设计错误处理策略
不同异常不应该采用完全相同的操作。
网络异常适合提示用户检查网络,并根据接口特点进行有限重试。HTTP 认证异常通常需要刷新令牌或重新登录。业务异常则应该直接展示业务规则对应的信息。
合理的异常分层可以让日志更准确,也能避免用户看到“服务器错误”等无法理解的提示。
按自己的节奏,确认真正理解。