跨平台开发 / 系统课时
处理 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 协议错误、业务规则错误。分层后,应用才能针对不同失败原因采取正确动作。
按自己的节奏,确认真正理解。