计算机网络 / 系统课时

使用 HEAD 检查资源

使用 HEAD 检查资源

HEAD 适合在不接收响应内容的情况下检查资源状态和元数据。它的请求语义与 GET 对应,但成功响应不传输消息内容,因此常用于探测资源是否存在、读取缓存验证字段,或在下载大文件前检查类型和大小。

学习目标

  • 理解 HEAD 与 GET 在响应内容上的关键区别。
  • 能使用 HEAD 检查状态码、Content-Type、ETag 等资源元数据。
  • 能识别 HEAD 返回 404、405 或缺少部分响应字段时应如何处理。

HEAD 只取响应元数据

对同一资源而言,HEAD 与 GET 的目标相同,但服务器不会在 HEAD 响应中发送消息内容。服务器通常会提供与 GET 对应的响应字段,但某些只有生成内容后才能确定的字段允许被省略。

片段示例:以下命令假设本地测试服务提供 /files/manual.pdf,并正确实现 HEAD。

bash
curl -I http://localhost:8080/files/manual.pdf

预期输出可以类似下面这样,实际日期、长度和 ETag 会随资源变化:

text
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。

bash
curl -sS -I -o /dev/null -w 'status=%{http_code} body_bytes=%{size_download}\n' http://localhost:8080/files/manual.pdf

预期输出:

text
status=200 body_bytes=0

body_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 返回一致的状态和关键元数据,同时省略响应内容。这样健康检查、下载器和缓存组件可以低成本探测资源,而不必为了确认一个状态码就传输完整文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 HEAD 检查资源

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

登录哪都通