要真正读懂状态码,先认识几个 HTTP 基础术语。

状态行

HTTP 响应第一行就是状态行,格式为“协议版本 + 状态码 + 原因短语”,例如 HTTP/1.1 404 Not Found。状态码是其中最关键的数字。

五类状态码

  • 1xx 信息性响应:请求已收到,正在处理。
  • 2xx 成功:请求被理解并接受了,如 200、201、204。
  • 3xx 重定向:需要额外操作完成请求,如 301、302、304。
  • 4xx 客户端错误:请求有语法错误或无法完成,如 400、401、404、429。
  • 5xx 服务器错误:服务器未能完成明显有效的请求,如 500、502、503。

请求方法

GET、POST、PUT、DELETE 等,状态码常与方法配合理解。例如对只读接口调用 DELETE 会返回 405 方法不允许。

响应头

携带状态码之外的信息,如 Retry-After 会提示 429 限流后多久再试。

掌握这些术语,阅读接口文档和排查报错都会更顺手。