计算机网络 / 系统课时

理解 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 有条件重试、降级并告警

HTTP 状态码分类与处理路径

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 后运行。

python
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()

预期输出如下;实际端口可按本机环境调整。

text
/ok 200 -
/moved 301 /ok
/missing 404 -
/fail 500 -

程序把 301 当作需要额外动作的响应,把 404 和 500 作为 HTTPError 捕获。生产代码还应读取响应体中的错误码和追踪标识,但不能用业务字段覆盖 HTTP 状态码的基本语义。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 HTTP 状态码

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通