状态码

HTTP Status Codes

HTTP 状态码速查表

从 100 到 511,常见状态码的中文含义、典型场景和该往哪里查,都放在一张表里。 输入编号或关键词即可筛选,排查线上报错时不用再翻文档。

57 条收录 即时搜索 排查提示

状态码列表

编号名称含义与排查

使用说明

五类状态码

  • 1xx 信息:请求已收到,继续处理,如 101 切换协议
  • 2xx 成功:请求正常处理完成,如 200、201、204
  • 3xx 重定向:需要进一步操作,如 301、302、304
  • 4xx 客户端错误:请求本身有问题,如 400、401、403、404、429
  • 5xx 服务端错误:服务端处理失败,如 500、502、503、504

排查顺序建议

先看是哪一类:4xx 优先查请求参数、鉴权与路径;5xx 优先查服务日志与上游健康状态。 带网关的架构(Nginx、SLB、CDN)出现 502/504 时,先确认上游进程是否存活,再看超时配置。

容易被忽略的几个

  • 429 限流:检查是否触发 QPS 限制,注意响应头里的 Retry-After
  • 413 请求体过大:多为上传超限,需要调 client_max_body_size
  • 499 客户端主动断开:Nginx 私有码,通常是客户端超时先放弃了

常见问题

502 和 504 有什么区别?

502 是网关连上了上游但收到无效响应,多为上游进程异常;504 是网关等上游超时,多为上游处理太慢或网络不通。

301 和 302 该用哪个?

永久迁移用 301,权重会转移;临时跳转用 302 或 307。301 会被浏览器长期缓存,配错难回滚,测试阶段先用 302。

401 和 403 有什么区别?

401 是没提供有效凭证(需要登录或刷新 Token);403 是凭证有效但无权限。重新登录解决不了 403。

304 响应为什么没有内容?

协商缓存命中,浏览器直接用本地缓存。需要请求带 If-None-Match 或 If-Modified-Since,服务端判断资源未变时返回 304。