计算机网络 / 系统课时

理解 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 内容协商从请求偏好到响应表示的选择流程

当响应可能随 Accept 改变时,共享缓存需要知道这个维度。常见做法是在响应中发送 Vary: Accept;否则缓存可能把给 JSON 客户端的表示错误复用于 HTML 客户端。

用 curl 看清请求头

下面的命令把 Accept: application/json 发给 httpbin,并只打印服务端回显的这一请求头;需要能够访问互联网,且本机安装 curl 与 Python 3。

bash
curl -sS -H 'Accept: application/json' https://httpbin.org/anything | python3 -c 'import json,sys; print(json.load(sys.stdin)["headers"]["Accept"])'

预期输出:

text
application/json

报文片段示例(不是可直接访问的真实服务,.test 是保留测试域名)可以写成:

text
GET /items HTTP/1.1
Host: api.example.test
Accept: application/json, text/html;q=0.5

如果服务器选择 JSON,响应至少应让客户端看到实际媒体类型;若缓存按 Accept 区分,还应包含 Vary:

text
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:前者描述请求体格式,后者才描述期望的响应格式。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Accept 协商

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

登录哪都通