计算机网络 / 系统课时
理解 Accept 协商
理解 Accept 协商
Accept 是客户端对响应媒体类型的偏好声明,服务器据此在自己能提供的表示中选择一种,并用 Content-Type 告知实际返回格式。本课把权重、通配符、406 与缓存的 Vary 串起来,最后用 curl 验证请求头确实发出。
学习目标
- 能写出包含媒体类型、通配符和
q权重的Accept请求头。 - 能根据服务器可提供的格式判断应返回哪一种表示。
- 能区分
Accept、Content-Type与Vary: Accept的职责。
Accept 表达的是响应偏好
Accept 放在请求里,描述“我愿意接收什么”;Content-Type 放在响应里,描述“我实际发回了什么”。没有 Accept 时,HTTP 语义上等价于客户端没有限制可接受的媒体类型;它并不要求服务器一定返回 JSON 或 HTML。
| 请求头示例 | 含义 |
|---|---|
Accept: application/json |
只明确偏好 JSON |
Accept: text/html, application/json;q=0.8 |
HTML 权重 1.0,JSON 权重 0.8 |
Accept: application/*;q=0.7, */*;q=0.1 |
任意 application 子类型优先于完全通配 |
Accept: image/avif;q=0 |
q=0 表示该范围不可接受 |
q 的范围是 0 到 1,HTTP 质量值最多使用三位小数。没有显式 q 时默认权重为 1。实际选择还会考虑媒体范围的匹配程度与参数,不能只把字符串从左到右取第一个。
服务器如何选择表示
假设 /items 同时能生成 text/html 与 application/json。收到 Accept: application/json;q=0.9, text/html;q=0.8 时,JSON 的匹配权重更高,服务器可以返回 application/json;若客户端把 JSON 设为 q=0,就不应把 JSON 当作可接受表示。

当响应可能随 Accept 改变时,共享缓存需要知道这个维度。常见做法是在响应中发送 Vary: Accept;否则缓存可能把给 JSON 客户端的表示错误复用于 HTML 客户端。
用 curl 看清请求头
下面的命令把 Accept: application/json 发给 httpbin,并只打印服务端回显的这一请求头;需要能够访问互联网,且本机安装 curl 与 Python 3。
curl -sS -H 'Accept: application/json' https://httpbin.org/anything | python3 -c 'import json,sys; print(json.load(sys.stdin)["headers"]["Accept"])'预期输出:
application/json报文片段示例(不是可直接访问的真实服务,.test 是保留测试域名)可以写成:
GET /items HTTP/1.1
Host: api.example.test
Accept: application/json, text/html;q=0.5如果服务器选择 JSON,响应至少应让客户端看到实际媒体类型;若缓存按 Accept 区分,还应包含 Vary:
HTTP/1.1 200 OK
Content-Type: application/json
Vary: Accept协商失败与排查
当所有可用表示都与客户端声明不匹配时,服务器可以返回 406 Not Acceptable;HTTP 也允许服务器忽略该偏好并返回一个表示,因此客户端不能假设“不匹配必然等于 406”。固定只返回 JSON 的 API 也不会因为客户端写了 Accept: text/html 就自动生成 HTML。
排查时按三个点核对:先确认请求实际发出的 Accept;再确认响应 Content-Type 是否属于服务端支持范围;最后检查有内容协商的缓存响应是否带 Vary: Accept。不要用请求里的 Content-Type 代替 Accept:前者描述请求体格式,后者才描述期望的响应格式。