计算机网络 / 系统课时

使用 ETag 验证资源

使用 ETag 验证资源

ETag 是服务器给某个资源表示分配的版本标识。客户端把上次收到的标签放进 If-None-Match,服务器就能判断内容是否仍可复用:未变化返回 304,已变化返回新的 200、正文和新标签,从而避免无意义地重复传输正文。

学习目标

  • 读懂强 ETag、弱 ETag 与 If-None-Match 的基本语义。
  • 完成一次“首次 200 → 条件 GET → 304”的验证流程。
  • 为需要频繁确认新鲜度的资源选择合适的缓存指令。

ETag 是不透明的版本标识

强标签写成 "v1-7f3a",弱标签写成 W/"v1-7f3a"。客户端不应解析标签内部的版本号、哈希或时间戳,只需原样保存并在后续条件请求中回传。标签如何生成由服务器决定,但同一资源表示发生足以影响验证结果的变化时,服务器应更新相应标签。

text
ETag: "v1-7f3a"
ETag: W/"v1-7f3a"

强标签表示可以进行字节级一致性判断;弱标签表示两个表示在语义上可视为等价,但字节不一定完全相同。If-None-Match 使用弱比较,因此常用于 GET/HEAD 的缓存重新验证;需要字节级前置条件时,If-Match 等场景要求强比较。

条件 GET 如何得到 304

首次请求没有验证器,服务器返回 200 OK、正文和 ETag。后续请求带上 If-None-Match;如果当前选中的表示仍匹配,GET 或 HEAD 返回 304 Not Modified,不再发送表示正文。若资源已变化,则返回新的 200、新正文和新 ETag。

ETag 条件请求从首次 200 到命中 304 的验证时序

下面的示例用 Node.js 18+ 启动一个最小 HTTP 服务,并用 curl 连续请求两次。服务器把 Cache-Control 设为 no-cache,允许存储响应,但要求复用前先验证。

bash
cat > etag-demo.mjs <<'EOF'
import http from "node:http";

const body = '{"name":"manual","version":1}\n';
const etag = '"v1-7f3a"';

const server = http.createServer((req, res) => {
  if (req.headers["if-none-match"] === etag) {
    res.writeHead(304, {
      "ETag": etag,
      "Cache-Control": "no-cache"
    });
    res.end();
    return;
  }

  res.writeHead(200, {
    "Content-Type": "application/json",
    "Content-Length": Buffer.byteLength(body),
    "ETag": etag,
    "Cache-Control": "no-cache"
  });
  res.end(body);
});

server.listen(3001, "127.0.0.1");
EOF
node etag-demo.mjs >/tmp/etag-demo.log 2>&1 &
SERVER_PID=$!
sleep 1
FIRST_STATUS=$(curl -s -D headers.txt -o body.txt -w '%{http_code}' http://127.0.0.1:3001/manual)
ETAG=$(awk -F': ' 'tolower($1)=="etag" {gsub("\r","",$2); print $2}' headers.txt)
printf 'first status: %s\netag: %s\nbody: %s\n' "$FIRST_STATUS" "$ETAG" "$(cat body.txt)"
curl -s -o /dev/null -w 'second status: %{http_code}\nsecond body bytes: %{size_download}\n' -H "If-None-Match: $ETAG" http://127.0.0.1:3001/manual
kill "$SERVER_PID"

预期输出:

text
first status: 200
etag: "v1-7f3a"
body: {"name":"manual","version":1}
second status: 304
second body bytes: 0

如果把服务器当前的 etag 和 body 一起改成新版本,再发送旧的 If-None-Match,匹配就会失败,服务器应返回 200 和新正文,而不是 304。

选择强弱标签和缓存指令

需求 建议 原因
普通页面或 JSON 的缓存重新验证 强或弱 ETag + If-None-Match If-None-Match 可用弱比较判断是否可复用
字节完全一致很重要 强 ETag 弱标签不能证明字节级相同
每次复用前都验证 Cache-Control: no-cache + ETag 响应可存储,但使用前必须重新验证
完全禁止缓存存储 Cache-Control: no-store 缓存不保存正文,通常也就没有后续 ETag 复用机会

如果请求同时带有 If-None-Match 和 If-Modified-Since,服务器在条件 GET 中应优先处理 If-None-Match;存在 If-None-Match 时,If-Modified-Since 不再作为主要验证条件。实际排错时先确认客户端是否真的回传了服务器上次给出的标签,再检查服务器在内容变化时是否同步更新 ETag。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 ETag 验证资源

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

登录哪都通