计算机网络 / 系统课时

理解常用 HTTP 首部

理解常用 HTTP 首部

HTTP 首部为请求和响应补充上下文:客户端想接收什么、正文是什么格式、凭证如何携带,以及资源应跳转到哪里。本课用一组常见首部和一个本地可运行示例,建立“首部名称、所在方向、实际作用”之间的对应关系。

学习目标

  • 区分请求首部、响应首部与实体描述首部
  • 理解 Host、Content-Type、Authorization、Accept、User-Agent、Location 的职责
  • 能从请求与响应中定位格式、认证和重定向问题

首部位于报文的什么位置

HTTP 报文由起始行、若干首部、空行和可选正文组成。请求首部主要描述客户端、目标与期望;响应首部主要描述服务器的处理结果;Content-Type 等首部则用于说明当前正文的媒体类型。

同一个名称未必只属于一个方向。例如 Content-Type 既可出现在请求中,说明提交数据的格式,也可出现在响应中,说明返回正文的格式。判断首部含义时,应同时观察它所在的请求或响应。

六个常用首部

首部 常见方向 核心作用
Host 请求 指定目标主机和可选端口,使同一 IP 上的虚拟主机能够区分请求
Content-Type 请求或响应 描述当前正文的媒体类型,如 application/json
Authorization 请求 携带认证凭证,例如 Bearer 访问令牌
Accept 请求 声明客户端希望接收的响应媒体类型
User-Agent 请求 标识客户端软件及版本,常用于兼容性分析和日志统计
Location 响应 给出重定向目标,通常配合 3xx 状态码使用

Accept 与 Content-Type 最容易混淆:前者表达“我希望收到什么”,后者表达“我现在发送或返回的正文是什么”。Authorization 只负责传递凭证,不代表服务器一定接受该凭证。

运行一个首部观察示例

下面的程序在本机启动临时 HTTP 服务,再发送一次带常用请求首部的 GET 和一次 JSON POST。服务端返回 302 与 Location,客户端禁止自动跳转,因此可以直接观察重定向响应。

python
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from threading import Thread
from urllib.error import HTTPError
from urllib.request import HTTPRedirectHandler, ProxyHandler, Request, build_opener
import json

class NoRedirect(HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != "/start":
            self.send_error(404)
            return
        names = ("Host", "Authorization", "Accept", "User-Agent")
        received = {name: self.headers.get(name) for name in names}
        print(json.dumps(received, ensure_ascii=False))
        self.send_response(302)
        self.send_header("Location", "/next")
        self.end_headers()

    def do_POST(self):
        length = int(self.headers.get("Content-Length", "0"))
        body = self.rfile.read(length).decode("utf-8")
        print(self.headers.get("Content-Type"))
        print(body)
        self.send_response(204)
        self.end_headers()

    def log_message(self, format, *args):
        pass

server = ThreadingHTTPServer(("127.0.0.1", 0), Handler)
Thread(target=server.serve_forever, daemon=True).start()
port = server.server_address[1]
opener = build_opener(ProxyHandler({}), NoRedirect)

get_request = Request(
    f"http://127.0.0.1:{port}/start",
    headers={
        "Authorization": "Bearer demo-token",
        "Accept": "application/json",
        "User-Agent": "Anystack-Learner/1.0",
    },
)
try:
    opener.open(get_request)
except HTTPError as exc:
    print(exc.code, exc.headers["Location"])

data = json.dumps({"message": "hello"}).encode("utf-8")
post_request = Request(
    f"http://127.0.0.1:{port}/next",
    data=data,
    method="POST",
    headers={"Content-Type": "application/json"},
)
with opener.open(post_request) as response:
    print(response.status)

server.shutdown()

预期输出

text
{"Host": "127.0.0.1:<PORT>", "Authorization": "Bearer demo-token", "Accept": "application/json", "User-Agent": "Anystack-Learner/1.0"}
302 /next
application/json
{"message": "hello"}
204

<PORT> 是程序随机分配的本地端口,实际值每次可能不同。第一行中的 Host 由客户端库自动生成;302 /next 表示服务器通过 Location 指示后续目标;POST 部分则证明 Content-Type 描述的是本次请求正文。

关键边界与排查顺序

HTTP/1.1 请求通常必须包含 Host。在 HTTP/2 和 HTTP/3 中,相同目标信息由协议层的 :authority 伪首部承载,开发者在常见客户端 API 中仍通常通过 URL 或 Host 配置目标。

遇到接口返回格式错误时,先核对请求 Content-Type 与实际正文是否一致,再检查 Accept 是否限制了响应格式。遇到 401 或 403 时,检查 Authorization 的方案名、令牌内容与有效期。遇到 3xx 时,查看 Location,并确认客户端是否自动跟随跳转。

User-Agent 可以被客户端自行设置,不能作为可靠身份凭证。服务端若需要鉴权,应验证签名、令牌或会话,而不是信任客户端声明的名称。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解常用 HTTP 首部

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

登录哪都通