计算机网络 / 系统课时
使用 Vary 区分缓存
使用 Vary 区分缓存
同一个 URL 可能因为语言、压缩方式或其他请求头返回不同表示。本课用 Vary 明确这些差异,让浏览器、代理缓存和 CDN 不会把一种版本错误复用给另一类请求,并通过本地 HTTP 服务验证响应头与内容是否一致。
学习目标
- 能解释
Vary如何参与缓存命中判断,以及它与Cache-Control的职责差异。 - 能为
Accept-Language、Accept-Encoding等协商维度选择合适的Vary字段。 - 能用
curl检查不同请求头是否得到对应版本,并识别Vary: *等高风险配置。
Vary 如何改变缓存匹配
缓存首先按请求方法和目标 URI 寻找可用响应;当已存响应带有 Vary 时,还要比较 Vary 列出的请求头。比如响应带 Vary: Accept-Language,那么 /help 的中文请求与英文请求不能共用同一缓存版本。

Cache-Control 决定响应能否存、能存多久、是否必须验证;Vary 决定同一 URI 的已存响应要按哪些请求头区分。两者通常一起使用,而不是互相替代。对语言协商页面,一个常见响应是 Cache-Control: public, max-age=300 配合 Vary: Accept-Language。
用真实响应头拆分语言版本
下面示例适用于 Python 3.8+。它根据 Accept-Language 返回中文或英文,并在响应中发送 Vary: Accept-Language。保存为 vary_server.py 后运行即可。
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;时间等日志字段会因环境而不同。
127.0.0.1 - - [<TIME>] "GET / HTTP/1.1" 200 -这个服务没有引入缓存层,目的是先确认源站确实提供了“不同表示 + 正确的 Vary”。缓存层只有拿到这个响应头后,才有足够信息区分版本。
验证两个请求不会被当成同一表示
保持服务运行,在另一个终端分别请求中文和英文版本。curl 默认不充当 HTTP 缓存,因此这里验证的是源站协商结果与 Vary 声明是否一致。
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 等动态头可能不同。
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。只声明真正参与表示选择的字段,才能兼顾正确性与缓存命中率。