计算机网络 / 系统课时

认识请求头

认识请求头

HTTP 请求头负责携带目标主机、客户端信息、期望的数据格式以及认证凭证等元数据。理解 Host、User-Agent、Accept 和 Authorization 后,你就能看懂浏览器或接口客户端到底向服务器附带了什么条件,并快速定位内容协商和认证问题。

学习目标

  • 能说明 Host、User-Agent、Accept 和 Authorization 各自承担的职责
  • 能区分必须用于路由的信息、内容协商信息和认证凭证
  • 能用 curl 构造并观察一组真实 HTTP/1.1 请求头

四个常见请求头分别解决什么问题

下面四个字段经常同时出现在 HTTP/1.1 请求中,但它们解决的问题完全不同。排查时不要只看字段是否存在,还要检查它的值是否符合当前接口约定。

请求头 示例值 主要用途 常见检查点
Host api.example.com 指明目标主机和可选端口 HTTP/1.1 请求必须提供,域名或端口错误可能被路由到错误站点
User-Agent curl/8.7.1 标识发起请求的客户端软件 适合日志分析,但服务端不应仅凭它判断客户端真实身份
Accept application/json 告诉服务器客户端希望接收哪些媒体类型 若服务器无法提供可接受格式,可能返回 406 Not Acceptable
Authorization Bearer <TOKEN> 携带访问受保护资源所需的认证信息 凭证错误或失效时常见 401 Unauthorized

Host 在 HTTP/1.1 中尤其重要,因为同一 IP 地址可以承载多个网站。服务器通常会先根据主机名选择虚拟主机,再把请求交给对应应用处理。

Accept 控制希望收到的数据格式

假设接口既能返回 JSON,也能返回其他表示形式,客户端可用 Accept 明确偏好。请求 application/json 表示客户端希望响应的媒体类型为 JSON,而不是声明自己发送的请求正文是 JSON;后者通常由 Content-Type 描述。

例如下面的请求明确要求接收 JSON:

text
GET /users/42 HTTP/1.1
Host: api.example.com
Accept: application/json

如果请求同时写成 Accept: application/json, text/plain;q=0.5,表示 JSON 优先级更高,纯文本仍可接受但优先级较低。q 的取值范围为 0 到 1,未显式指定时默认权重为 1。

Authorization 携带认证凭证

常见 API 会使用 Bearer 方案,把访问令牌放在 Authorization 请求头中。例如:

text
Authorization: Bearer <TOKEN>

<TOKEN> 代表实际令牌,每个系统的令牌格式和长度可能不同。这个字段应通过 HTTPS 发送,并避免出现在公开日志、截图、错误报告或代码仓库中。仅仅隐藏页面上的令牌并不能保护它,真正需要保护的是请求中实际发送的凭证值。

服务器如果无法识别或接受凭证,常见结果是 401 Unauthorized;客户端已经通过认证但无权访问某项资源时,服务端常使用 403 Forbidden。具体状态码仍应以目标 API 的认证设计为准。

用 curl 观察自己发送的请求头

下面命令强制使用 HTTP/1.1,并主动设置 Accept 与示例 Bearer 凭证。-v 会把请求和响应细节写到标准错误,因此使用 2>&1 合并输出,再筛选以 > 开头的请求行和请求头。示例适用于 Bash 环境。

bash
curl --http1.1 -v -o /dev/null -H 'Accept: application/json' -H 'Authorization: Bearer <TOKEN>' https://example.com/ 2>&1 | grep '^> '

预期输出中的关键部分类似下面这样;curl 版本号可能不同。

text
> GET / HTTP/1.1
> Host: example.com
> User-Agent: curl/<VERSION>
> Accept: application/json
> Authorization: Bearer <TOKEN>

这里可以直接验证四件事:目标主机是 example.com,curl 自动提供了 User-Agent,显式设置的 Accept 已生效,Authorization 也被加入请求。实际排障时若使用真实令牌,不要把完整的 -v 输出直接贴进工单或聊天记录,应先删除或遮蔽认证信息。

HTTP/2 和 HTTP/3 对头字段的线路编码方式与 HTTP/1.1 不同,并使用 :authority、:method 等伪首部表达部分信息;但从应用开发角度看,Accept 和 Authorization 等字段承担的职责仍然基本一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

认识请求头

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

登录哪都通