计算机网络 / 系统课时
使用 HEAD 检查资源
使用 HEAD 检查资源
HEAD 适合在不接收响应内容的情况下检查资源状态和元数据。它的请求语义与 GET 对应,但成功响应不传输消息内容,因此常用于探测资源是否存在、读取缓存验证字段,或在下载大文件前检查类型和大小。
学习目标
- 理解 HEAD 与 GET 在响应内容上的关键区别。
- 能使用 HEAD 检查状态码、Content-Type、ETag 等资源元数据。
- 能识别 HEAD 返回 404、405 或缺少部分响应字段时应如何处理。
HEAD 只取响应元数据
对同一资源而言,HEAD 与 GET 的目标相同,但服务器不会在 HEAD 响应中发送消息内容。服务器通常会提供与 GET 对应的响应字段,但某些只有生成内容后才能确定的字段允许被省略。
片段示例:以下命令假设本地测试服务提供 /files/manual.pdf,并正确实现 HEAD。
curl -I http://localhost:8080/files/manual.pdf预期输出可以类似下面这样,实际日期、长度和 ETag 会随资源变化:
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Length: 842176
ETag: "manual-v12"
Last-Modified: <TIME>这里没有 PDF 内容本身。若 HEAD 响应包含 Content-Length: 842176,这个数值描述的是对应 GET 响应所选表示的长度,而不是说 HEAD 实际下载了 842176 字节。
用响应字段决定下一步操作
文件下载器可以先发 HEAD,再根据元数据决定是否真正 GET。一个 842176 字节的 PDF 可以直接下载;如果业务规定移动网络下超过 20 MB 必须确认,则可先读取 Content-Length,超过阈值时暂停下载。
常用检查字段包括:
| 字段或状态 | 可执行判断 |
|---|---|
200 OK |
当前请求成功,可继续读取响应字段 |
404 Not Found |
当前 URI 没有可访问的目标资源 |
Content-Type |
判断是否为预期的 PDF、图片或其他媒体类型 |
Content-Length |
字段存在时可用于预估 GET 的传输大小 |
ETag |
保存版本标识,后续可用于条件请求 |
Last-Modified |
获取服务器提供的最后修改时间 |
不要把“缺少 Content-Length”直接解释成文件为空。动态响应、压缩策略或服务端实现方式都可能使 HEAD 没有这个字段;此时客户端应把长度视为未知,而不是当作 0 字节。
验证确实没有下载响应内容
只观察屏幕上没有正文还不够,可以让 curl 输出最终状态码和实际接收到的响应内容字节数。-I 使用 HEAD,-o /dev/null 丢弃普通输出,-w 打印 curl 统计值。
片段示例:仍假设本地 /files/manual.pdf 返回 200。
curl -sS -I -o /dev/null -w 'status=%{http_code} body_bytes=%{size_download}\n' http://localhost:8080/files/manual.pdf预期输出:
status=200 body_bytes=0body_bytes=0 验证本次 HEAD 没有接收响应内容。若需要比较 GET 与 HEAD 的字段是否一致,应分别请求同一 URI,并重点核对 Content-Type、ETag、缓存字段等元数据,而不是期待 HEAD 出现正文。
处理不支持 HEAD 的接口
HEAD 是标准方法,但具体资源仍可能返回 405 Method Not Allowed。遇到 405 时,不能把它解释为资源不存在:它只说明服务器识别 HEAD,却不允许当前目标使用该方法。接口若返回 Allow 字段,还可以据此查看允许的方法。
对于自己维护的 HTTP API,如果 GET /reports/2026.pdf 能提供大文件,通常也应让对应 HEAD 返回一致的状态和关键元数据,同时省略响应内容。这样健康检查、下载器和缓存组件可以低成本探测资源,而不必为了确认一个状态码就传输完整文件。