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 才参与判断“我手里的副本是不是仍然对应当前版本”。
一个典型流程会经历初次获取、保存验证器、再次条件请求,以及“未变化”或“已变化”两个分支。

第一次响应先拿到验证器
下面是 HTTP 报文片段示例。假设服务器为 /article/42 当前表示生成了 "article-42-v7" 这个 ETag;具体生成算法由服务器决定,客户端不应自行解释其内部含义。
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;实际值必须以第一次响应为准。
curl -i \
-H 'If-None-Match: "article-42-v7"' \
http://<HOST>:<PORT>/article/42若服务器当前所选表示的实体标签与条件匹配,预期输出的关键部分是:
HTTP/1.1 304 Not Modified
ETag: "article-42-v7"
...Date、Server 等动态头部可能不同。对于 GET 或 HEAD,匹配 If-None-Match 时服务器应返回 304 Not Modified,而不是再次传输完整表示;客户端继续使用自己已缓存的响应体。
如果资源已经变化,下面是新的响应片段示例:
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 时可以返回:
ETag: W/"article-42-v7"预期结果:客户端会把它作为验证器保存,并可在后续条件请求中原样发送。是否生成强 ETag 或弱 ETag,应由服务器根据内容生成方式和一致性需求决定,而不是让客户端自行转换。
验证时最容易混淆的边界
ETag 不是资源 ID,也不是客户端可解释的版本号协议;它的字符串内容对客户端是不透明的。服务器可以用内容哈希、数据库版本字段或其他机制生成它,只要满足所需验证语义即可。
如果中间代理会压缩、转码或重写响应体,还要确认 ETag 对应的是哪一种表示。可靠的检查方法是记录第一次响应得到的 ETag,用相同资源 URL 发起 If-None-Match 请求,再观察服务端是否按“匹配返回 304、不匹配返回当前表示”的规则工作。