跨平台开发 / 系统课时

处理 4xx 和 5xx 响应

处理 4xx 和 5xx 响应

HTTP 状态码反映服务器与客户端之间的请求结果,但不同状态码需要不同处理策略。本篇学习如何在 Flutter 网络层区分 4xx 客户端问题和 5xx 服务端异常,并转换为业务可理解的错误结果。

学习目标

  • 理解 4xx 与 5xx 状态码在应用中的处理差异
  • 实现基于状态码的错误分类逻辑
  • 掌握鉴权失败、参数错误和服务器故障的处理方式

区分客户端错误和服务端错误

HTTP 状态码通常可以帮助应用判断下一步动作。

状态码范围 含义 常见处理
400-499 客户端请求问题 检查参数、登录状态或权限
500-599 服务端处理失败 提示稍后重试并记录日志

4xx 不一定代表程序错误。例如用户输入无效参数、登录过期、没有权限访问资源,都可能属于正常业务流程。

5xx 通常表示服务端暂时无法完成请求,客户端一般不应该修改请求内容,而应该考虑重试或等待恢复。

根据状态码转换错误

在网络层收到 HTTP 响应后,可以根据状态码生成统一错误对象。

dart
class ApiException implements Exception {
  final String message;
  final int statusCode;

  ApiException(this.message, this.statusCode);
}

NetworkFailure handleHttpError(ApiException error) {
  final code = error.statusCode;

  if (code == 401 || code == 403) {
    return NetworkFailure(
      message: '登录状态失效或没有访问权限',
      canRetry: false,
      statusCode: code,
    );
  }

  if (code >= 400 && code < 500) {
    return NetworkFailure(
      message: '请求参数或业务条件不正确',
      canRetry: false,
      statusCode: code,
    );
  }

  if (code >= 500 && code < 600) {
    return NetworkFailure(
      message: '服务器暂时不可用',
      canRetry: true,
      statusCode: code,
    );
  }

  return NetworkFailure(
    message: error.message,
    canRetry: false,
    statusCode: code,
  );
}

预期结果

text
401 或 403 响应转换为权限错误。
400-499 响应转换为客户端请求错误。
500-599 响应转换为可重试的服务端错误。

在业务层处理不同错误

页面层不应该再次判断 HTTP 状态码,否则网络逻辑会扩散到多个页面。

业务层只需要根据统一错误类型决定行为:

  • 权限错误:跳转登录或显示无权限提示
  • 参数错误:展示接口返回的业务提示
  • 服务端错误:显示重试入口
  • 网络错误:提示检查网络连接

这种方式可以保持 UI 与接口协议解耦。

处理状态码之外的错误信息

实际接口通常还会返回业务错误码,例如用户不存在、库存不足、订单状态异常等。这些信息属于业务协议,不应简单归类为 HTTP 错误。

推荐处理顺序是:先判断网络是否成功,再解析 HTTP 状态,最后解析业务错误码。

例如 HTTP 200 但响应体中包含业务失败状态,也需要转换为业务错误对象。

因此,错误处理通常分为三层:网络连接错误、HTTP 协议错误、业务规则错误。分层后,应用才能针对不同失败原因采取正确动作。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理 4xx 和 5xx 响应

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

登录哪都通