nginx gzip_vary on 和 off 具体代码什么意思

2026-2-8 杜世伟

你想弄清楚 Nginx 中 gzip_vary on 和 off 的具体含义，核心是理解这个配置如何影响 HTTP 响应头的 Vary 字段，以及它对缓存系统的作用，我用通俗的语言给你讲明白：

Vary 是 HTTP 响应头的一个字段，作用是告诉缓存服务器（CDN、代理服务器、浏览器缓存）：这个响应的内容会根据哪些请求头的不同而变化。

行为：当 Nginx 开启 gzip 且对资源做了压缩时，会在响应头中添加 Vary: Accept-Encoding。
含义：告诉所有缓存系统（CDN / 代理 / 浏览器）： “这个资源的内容会根据请求头里的 Accept-Encoding 不同而变化 —— 比如浏览器传 Accept-Encoding: gzip 时我返回压缩后的内容，不传时返回原始内容，这两种内容是不一样的，缓存时要分开存！”
举个实际例子：

响应头会多出这一行：Vary: Accept-Encoding

行为：即使 Nginx 开启了 gzip 并压缩了资源，也不会在响应头中添加 Vary: Accept-Encoding。
问题：缓存系统无法区分 “压缩版资源” 和 “未压缩版资源”，可能出现严重的缓存错误：
- 比如：缓存服务器把 “gzip 压缩后的 JS 文件” 缓存了，然后把这个压缩文件返回给不支持 gzip 的老旧浏览器（比如 IE6），浏览器无法解压，直接显示乱码。
- 或者：把未压缩的资源返回给支持 gzip 的浏览器，白白浪费带宽。

只要满足以下任一情况，就必须开：

只有一种极端情况可关：服务器直接暴露给用户，无任何缓存 / 代理层，且能确保所有访问者的浏览器都支持 gzip（几乎不存在这种场景）。

配置	响应头是否包含 `Vary: Accept-Encoding`	缓存系统行为
`gzip_vary on`	是	分开缓存压缩 / 未压缩版本，避免乱码
`gzip_vary off`	否	可能混存版本，老旧浏览器会显示乱码

gzip_vary on：强制 Nginx 在响应头添加 Vary: Accept-Encoding，告诉缓存系统 “压缩 / 未压缩资源要分开缓存”，是保障缓存正确性的关键配置；
gzip_vary off：不添加该响应头，可能导致缓存系统返回错误的资源版本（如给不支持 gzip 的浏览器返回压缩文件），引发乱码问题；
只要开启了 gzip 压缩，gzip_vary 就必须设为 on，无任何负面作用。