计算机网络 / 系统课时
认识请求头
认识请求头
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:
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 请求头中。例如:
Authorization: Bearer <TOKEN><TOKEN> 代表实际令牌,每个系统的令牌格式和长度可能不同。这个字段应通过 HTTPS 发送,并避免出现在公开日志、截图、错误报告或代码仓库中。仅仅隐藏页面上的令牌并不能保护它,真正需要保护的是请求中实际发送的凭证值。
服务器如果无法识别或接受凭证,常见结果是 401 Unauthorized;客户端已经通过认证但无权访问某项资源时,服务端常使用 403 Forbidden。具体状态码仍应以目标 API 的认证设计为准。
用 curl 观察自己发送的请求头
下面命令强制使用 HTTP/1.1,并主动设置 Accept 与示例 Bearer 凭证。-v 会把请求和响应细节写到标准错误,因此使用 2>&1 合并输出,再筛选以 > 开头的请求行和请求头。示例适用于 Bash 环境。
curl --http1.1 -v -o /dev/null -H 'Accept: application/json' -H 'Authorization: Bearer <TOKEN>' https://example.com/ 2>&1 | grep '^> '预期输出中的关键部分类似下面这样;curl 版本号可能不同。
> 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 等字段承担的职责仍然基本一致。