如何通过Nginx Gzip-Vary头部防止压缩内容缓存欺骗？

本文共计701个文字，预计阅读时间需要3分钟。

确保同时启用gzip压缩和设置Vary头，否则缓存系统可能会将gzip响应错误地发送给不支持压缩的客户端，导致页面空白或乱码。

为什么只开 gzip_vary on 不够

Nginx 的 gzip_vary on 仅在实际执行了压缩时才添加 Vary: Accept-Encoding 响应头。但若请求未携带 Accept-Encoding: gzip（比如某些旧爬虫、测试工具或禁用压缩的浏览器），Nginx 不压缩、也不加 Vary 头——此时缓存系统（CDN 或代理）会把该“未压缩响应”当作通用副本缓存，后续带 Accept-Encoding: gzip 的请求可能被错误返回未压缩内容，造成 JS/CSS 解析失败。

• 现象：同一 URL，部分用户看到空白页或控制台报 Unexpected token
• 根本原因：缓存键未区分压缩变体，Vary 缺失导致“一缓存多用”
• gzip_vary on 是条件性行为，不能保证所有响应都带 Vary

正确配置：强制统一声明 Vary: Accept-Encoding

在 location 或 server 块中显式添加 add_header Vary Accept-Encoding，覆盖 Nginx 的条件逻辑，确保每个响应（无论是否压缩）都携带该头。