计算机网络 / 系统课时

使用 Vary 区分缓存

使用 Vary 区分缓存

同一个 URL 可能因为语言、压缩方式或其他请求头返回不同表示。本课用 Vary 明确这些差异,让浏览器、代理缓存和 CDN 不会把一种版本错误复用给另一类请求,并通过本地 HTTP 服务验证响应头与内容是否一致。

学习目标

  • 能解释 Vary 如何参与缓存命中判断,以及它与 Cache-Control 的职责差异。
  • 能为 Accept-Language、Accept-Encoding 等协商维度选择合适的 Vary 字段。
  • 能用 curl 检查不同请求头是否得到对应版本,并识别 Vary: * 等高风险配置。

Vary 如何改变缓存匹配

缓存首先按请求方法和目标 URI 寻找可用响应;当已存响应带有 Vary 时,还要比较 Vary 列出的请求头。比如响应带 Vary: Accept-Language,那么 /help 的中文请求与英文请求不能共用同一缓存版本。

Vary 根据请求头把同一 URL 拆成多个缓存版本

Cache-Control 决定响应能否存、能存多久、是否必须验证;Vary 决定同一 URI 的已存响应要按哪些请求头区分。两者通常一起使用,而不是互相替代。对语言协商页面,一个常见响应是 Cache-Control: public, max-age=300 配合 Vary: Accept-Language。

用真实响应头拆分语言版本

下面示例适用于 Python 3.8+。它根据 Accept-Language 返回中文或英文,并在响应中发送 Vary: Accept-Language。保存为 vary_server.py 后运行即可。

python
from http.server import BaseHTTPRequestHandler, HTTPServer

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        language = self.headers.get("Accept-Language", "")
        is_zh = language.lower().startswith("zh")
        body = ("你好,缓存!" if is_zh else "Hello, cache!").encode("utf-8")

        self.send_response(200)
        self.send_header("Content-Type", "text/plain; charset=utf-8")
        self.send_header("Content-Language", "zh-CN" if is_zh else "en-US")
        self.send_header("Cache-Control", "public, max-age=300")
        self.send_header("Vary", "Accept-Language")
        self.send_header("Content-Length", str(len(body)))
        self.end_headers()
        self.wfile.write(body)

HTTPServer(("127.0.0.1", 8000), Handler).serve_forever()

预期结果:进程持续监听 127.0.0.1:8000,终端在收到请求后会记录 GET / HTTP/1.1 和状态码 200;时间等日志字段会因环境而不同。

text
127.0.0.1 - - [<TIME>] "GET / HTTP/1.1" 200 -

这个服务没有引入缓存层,目的是先确认源站确实提供了“不同表示 + 正确的 Vary”。缓存层只有拿到这个响应头后,才有足够信息区分版本。

验证两个请求不会被当成同一表示

保持服务运行,在另一个终端分别请求中文和英文版本。curl 默认不充当 HTTP 缓存,因此这里验证的是源站协商结果与 Vary 声明是否一致。

bash
curl -i -H "Accept-Language: zh-CN" http://127.0.0.1:8000/
curl -i -H "Accept-Language: en-US" http://127.0.0.1:8000/

预期输出的关键部分如下,Date 等动态头可能不同。

text
HTTP/1.0 200 OK
Content-Language: zh-CN
Cache-Control: public, max-age=300
Vary: Accept-Language

你好,缓存!

HTTP/1.0 200 OK
Content-Language: en-US
Cache-Control: public, max-age=300
Vary: Accept-Language

Hello, cache!

如果生产环境前面还有 CDN,应再检查两次相同语言请求是否命中缓存,以及切换语言后是否回源或命中另一变体。CDN 的命中头名称因厂商不同,不要把某个厂商的 X-Cache 字段当成 HTTP 标准。

控制 Vary 维度,避免缓存碎片

Vary 不是“越多越安全”。每增加一个高基数字段,缓存可复用率都会下降。常见选择可以按实际表示差异来判断:内容真的随语言变化才使用 Accept-Language;内容真的随压缩编码变化才使用 Accept-Encoding。

场景 建议的 Vary 原因
gzip 与 br 压缩版本 Accept-Encoding 编码不同,字节内容不同
中英文页面 Accept-Language 表示内容不同
按设备类型返回完全不同 HTML 优先改为稳定的独立 URL;确有协商再考虑具体请求头 User-Agent 取值极多,容易造成缓存碎片
所有请求都不可复用 不要用 Vary: * 代替缓存策略 * 会让已存响应无法正常匹配后续请求

实际检查时,先问“响应正文或内容编码是否真的随这个请求头变化”,再决定是否加入 Vary。只声明真正参与表示选择的字段,才能兼顾正确性与缓存命中率。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Vary 区分缓存

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

登录哪都通