$sent_http_vary能反映资源隔离效果,因其精确捕获Nginx实际发出的Vary头值;若配置正确(如Vary: X-Device-Type),该变量显示对应值,否则为空或异常,直接暴露缓存键与Vary是否协同生效。

可以直接用 $sent_http_vary 变量观察 Nginx 实际发出的 Vary 响应头内容,从而判断缓存系统是否按预期对不同设备做了资源隔离。
为什么这个变量能反映资源隔离效果
$sent_http_vary 是 Nginx 内置变量,它捕获的是最终写入响应头中的 Vary 字段值(不是配置里写的原始字符串,而是真实发送出去的内容)。如果服务端正确设置了 Vary: User-Agent,该变量就会输出 User-Agent;若因条件分支未命中或配置被覆盖,它可能为空或为其他值——这直接暴露了缓存键生成逻辑是否生效。
在日志中记录并验证 Vary 行为
把变量加入 access_log 格式,便于批量分析:
log_format cache_debug '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_user_agent" "$sent_http_vary"';
然后查看日志片段:
-
192.168.1.100 - - [01/May/2026:10:22:33] "GET /home.html HTTP/1.1" 200 1245 "Mozilla/5.0 (iPhone; ...)" "User-Agent"→ 移动端请求携带了 Vary 头 -
192.168.1.101 - - [01/May/2026:10:22:35] "GET /home.html HTTP/1.1" 200 1245 "Mozilla/5.0 (Windows NT 10.0; ...)" ""→ 桌面端响应缺失 Vary,说明条件判断未覆盖该 UA
结合 map 指令动态控制 Vary 输出
仅靠 add_header Vary User-Agent 不够稳健,需配合 map 判断设备类型再决定是否设 Vary:
map $http_user_agent $vary_value {
~*"(iPhone|Android|Mobile)" "User-Agent";
default "";
}
add_header Vary $vary_value always;
这样可避免对爬虫、API 客户端等非渲染场景误加 Vary,减少缓存碎片。通过 $sent_http_vary 日志就能确认哪些 UA 触发了隔离逻辑。
排查 CDN 缓存错乱的关键线索
当发现移动端用户看到桌面版页面,或 gzip 压缩内容被未压缩客户端接收时,检查 $sent_http_vary 是否同时包含 User-Agent, Accept-Encoding:
- 只含
User-Agent→ CDN 可能将不同压缩格式混存 - 只含
Accept-Encoding→ 设备适配失效,所有 UA 共享同一份响应 - 两者齐全 → 隔离维度完整,问题可能出在 CDN 节点未遵守 Vary 或源站未真正生成差异化内容

















