HTTP 状态码速查手册:从 1xx 到 5xx 的语义与用法

按分类梳理常见 HTTP 状态码的含义与使用场景,给出排错建议与服务端/前端处理要点,附在线状态码大全与搜索入口。

2025年10月29日
HTTP状态码200404500重定向排错

分类总览

  • 1xx 信息:请求已接收,继续处理(如 100 Continue)。
  • 2xx 成功:请求成功(如 200 OK201 Created)。
  • 3xx 重定向:资源位置变化(如 301 永久、302 临时、304 协商缓存)。
  • 4xx 客户端错误:请求有误(如 400 参数错误、401/403 鉴权/权限问题、404 资源不存在)。
  • 5xx 服务器错误:服务端异常(如 500 未处理错误、502/504 网关/超时)。

常见情景与建议

  • 304 Not Modified:命中缓存不返回实体,注意 ETag/Last-Modified 配置。
  • 401 vs 403:未认证与已认证但无权限的区别。
  • 429 Too Many Requests:配合 Retry-After 与限流策略。

在线工具

前后端处理要点

  • 前端:根据状态码分层处理 UI 与重试;对 401/403 做跳转与提示。
  • 服务端:统一错误码与结构体,记录上下文日志,合理使用 4xx/5xx。

FAQ

  • 301/302/307/308 如何选? 持久 vs 临时、方法是否更改(307/308 不改变方法)。
  • 为什么本地是 200,线上 304? 受缓存策略影响,属于正常优化行为。

快速检索状态码与解释:/tools/develop/http-status-code