计算机网络 / 系统课时
理解 HTTP 状态码
理解 HTTP 状态码
HTTP 状态码是服务器对请求处理结果的三位数摘要。读懂首位分类、常见重定向差异和 4xx/5xx 的责任边界后,就能更快决定客户端应继续、重试、修改请求还是停止调用。
学习目标
- 按 1xx 至 5xx 判断响应所属类别
- 区分常见重定向、客户端错误与服务端错误
- 根据状态码选择修正、重试或降级策略
先看首位分类
状态码的首位数字给出处理结果的大方向,后两位用于细分语义。客户端应先按类别判断,再结合具体状态码、响应头和响应体处理。
| 类别 | 含义 | 常见示例 | 客户端动作 |
|---|---|---|---|
| 1xx | 请求已收到,仍在处理 | 100、101、103 | 继续等待或切换协议 |
| 2xx | 请求成功处理 | 200、201、204 | 消费结果或结束流程 |
| 3xx | 需要进一步动作 | 301、302、304、307、308 | 跟随位置、使用缓存或保留原方法 |
| 4xx | 请求侧存在问题 | 400、401、403、404、409、429 | 修正请求、权限或调用频率 |
| 5xx | 服务器未完成有效请求 | 500、502、503、504 | 有条件重试、降级并告警 |

1xx 多为中间响应,普通业务代码较少直接处理。2xx 也不都包含响应体:201 通常表示已创建,204 表示成功但无消息体。304 属于缓存协商结果,不表示业务失败。
重定向与错误边界
301 和 308 表示永久重定向,302 和 307 表示临时重定向。307、308 明确要求保留原请求方法和请求体;301、302 在历史客户端中可能把 POST 改成 GET。需要明确“提交后转到结果页”时,常使用 303,让客户端改用 GET。
4xx 通常意味着当前请求不能按原样成功。401 表示需要有效身份认证,403 表示服务器理解请求但拒绝授权,404 表示目标资源不可见或不存在,409 表示当前资源状态冲突,429 表示请求过多。修正前直接重复发送通常无效。
5xx 表示服务器或上游未完成一个看起来有效的请求。502 常见于网关收到无效上游响应,503 表示服务暂不可用,504 表示网关等待上游超时。只有请求可安全重放时才应自动重试,并配合指数退避、次数上限和随机抖动。
本地观察典型响应
下面的程序启动本地服务,并禁止客户端自动跟随重定向,从而直接观察 200、301、404 和 500。保存为 http_status_demo.py 后运行。
from http.server import BaseHTTPRequestHandler, HTTPServer
from threading import Thread
from urllib.error import HTTPError
from urllib.request import HTTPRedirectHandler, Request, build_opener
HOST = "127.0.0.1"
PORT = 18081
class Handler(BaseHTTPRequestHandler):
# 路径与状态码一一对应,输出保持稳定。
def do_GET(self):
routes = {
"/ok": (200, b"ok"),
"/moved": (301, b"moved"),
"/missing": (404, b"not found"),
"/fail": (500, b"server error"),
}
status, body = routes.get(self.path, (400, b"bad request"))
self.send_response(status)
if self.path == "/moved":
self.send_header("Location", "/ok")
self.send_header("Content-Length", str(len(body)))
self.end_headers()
self.wfile.write(body)
def log_message(self, format, *args):
pass
# 禁止自动跳转,确保能直接观察 301。
class NoRedirect(HTTPRedirectHandler):
def redirect_request(self, req, fp, code, msg, headers, newurl):
return None
server = HTTPServer((HOST, PORT), Handler)
Thread(target=server.serve_forever, daemon=True).start()
client = build_opener(NoRedirect)
# 同时覆盖成功、重定向、客户端错误和服务端错误。
for path in ["/ok", "/moved", "/missing", "/fail"]:
try:
response = client.open(Request(f"http://{HOST}:{PORT}{path}"))
print(path, response.status, response.headers.get("Location", "-"))
except HTTPError as error:
print(path, error.code, error.headers.get("Location", "-"))
server.shutdown()预期输出如下;实际端口可按本机环境调整。
/ok 200 -
/moved 301 /ok
/missing 404 -
/fail 500 -程序把 301 当作需要额外动作的响应,把 404 和 500 作为 HTTPError 捕获。生产代码还应读取响应体中的错误码和追踪标识,但不能用业务字段覆盖 HTTP 状态码的基本语义。