跨平台开发 / 系统课时

区分网络异常和业务异常

区分网络异常和业务异常

本篇解决 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 认证异常通常需要刷新令牌或重新登录。业务异常则应该直接展示业务规则对应的信息。

合理的异常分层可以让日志更准确,也能避免用户看到“服务器错误”等无法理解的提示。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分网络异常和业务异常

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

登录哪都通