HTTP 与 Web 标准 / 系统课时

用 ETag 判断内容是否变化

用 ETag 判断内容是否变化

ETag 给某个响应版本一个由服务器生成的验证标识。缓存下次请求同一资源时,可以把这个标识放进 If-None-Match;服务器比较后决定返回完整的 200 响应,还是仅用 304 Not Modified 告诉客户端继续使用本地副本。

学习目标

  • 理解 ETag 与 If-None-Match 在条件请求中的配合关系。
  • 判断服务器何时返回 304 Not Modified,何时必须返回新的实体内容。
  • 能用 curl 模拟一次 ETag 重新验证并检查结果。

ETag 解决的不是“缓存多久”

ETag 是验证器,不负责决定缓存能直接使用多久。资源是否处于新鲜期,通常由 Cache-Control 等响应头决定;当缓存需要重新验证时,ETag 才参与判断“我手里的副本是不是仍然对应当前版本”。

一个典型流程会经历初次获取、保存验证器、再次条件请求,以及“未变化”或“已变化”两个分支。

ETag 条件请求时序

第一次响应先拿到验证器

下面是 HTTP 报文片段示例。假设服务器为 /article/42 当前表示生成了 "article-42-v7" 这个 ETag;具体生成算法由服务器决定,客户端不应自行解释其内部含义。

http
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-cache
ETag: "article-42-v7"

{"id":42,"title":"HTTP cache"}

预期结果:客户端或缓存可以保存响应体以及对应的 ETag。因为这里使用 Cache-Control: no-cache,以后复用该副本前需要先向服务器重新验证。

条件请求让服务器只做版本判断

再次请求同一资源时,把之前保存的 ETag 放进 If-None-Match。下面命令假设 <HOST>:<PORT> 上的服务确实为该资源返回相同 ETag;实际值必须以第一次响应为准。

bash
curl -i \
  -H 'If-None-Match: "article-42-v7"' \
  http://<HOST>:<PORT>/article/42

若服务器当前所选表示的实体标签与条件匹配,预期输出的关键部分是:

text
HTTP/1.1 304 Not Modified
ETag: "article-42-v7"
...

Date、Server 等动态头部可能不同。对于 GET 或 HEAD,匹配 If-None-Match 时服务器应返回 304 Not Modified,而不是再次传输完整表示;客户端继续使用自己已缓存的响应体。

如果资源已经变化,下面是新的响应片段示例:

http
HTTP/1.1 200 OK
Content-Type: application/json
ETag: "article-42-v8"

{"id":42,"title":"HTTP caching"}

预期结果:客户端用新的响应体和 ETag 替换旧缓存;之后再验证时,应发送新的 If-None-Match 值。

服务器何时返回 304

对于 GET 或 HEAD 的 If-None-Match 条件请求,服务器使用弱比较判断请求中的实体标签是否与当前所选表示匹配。只要匹配,条件就不成立,服务器应返回 304 Not Modified;如果不匹配,则继续按普通请求处理,通常返回当前表示,例如 200 OK。

因此,304 不是“服务器没有内容”,而是“客户端已有可继续使用的内容”。

强 ETag 与弱 ETag

强 ETag 可用于需要字节级一致性判断的场景;弱 ETag 以 W/ 开头,表示两个表示在语义上等价,但字节内容可能不同。用于缓存重新验证的 If-None-Match 采用弱比较,因此弱 ETag 也能参与这一流程。

片段示例:服务器选择弱 ETag 时可以返回:

http
ETag: W/"article-42-v7"

预期结果:客户端会把它作为验证器保存,并可在后续条件请求中原样发送。是否生成强 ETag 或弱 ETag,应由服务器根据内容生成方式和一致性需求决定,而不是让客户端自行转换。

验证时最容易混淆的边界

ETag 不是资源 ID,也不是客户端可解释的版本号协议;它的字符串内容对客户端是不透明的。服务器可以用内容哈希、数据库版本字段或其他机制生成它,只要满足所需验证语义即可。

如果中间代理会压缩、转码或重写响应体,还要确认 ETag 对应的是哪一种表示。可靠的检查方法是记录第一次响应得到的 ETag,用相同资源 URL 发起 If-None-Match 请求,再观察服务端是否按“匹配返回 304、不匹配返回当前表示”的规则工作。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ETag 判断内容是否变化

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

登录哪都通