要真正读懂状态码,先认识几个 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 限流后多久再试。
掌握这些术语,阅读接口文档和排查报错都会更顺手。