Nginx正确压缩静态文本和JSON需精准配置：启用gzip模块，http块中设gzip on、gzip_min_length 1024、gzip_comp_level 5、显式列出gzip_types（含application/json等）、gzip_vary on及gzip_http_version 1.1，避免压缩已压缩二进制文件。
要在 Nginx 中正确压缩静态文本（如 HTML、CSS、JS）和 JSON 数据，关键不是简单打开 gzip，而是精准控制压缩对象、强度与执行方式——否则可能白开、压错、甚至拖慢服务。
确认模块已就位
运行以下命令检查 gzip 模块是否编译进当前 Nginx：
nginx -V 2>&1 | grep -o with-http_gzip_module有输出说明支持；若无结果，需重新编译并添加 --with-http_gzip_module 参数。注意：gzip_static 是独立模块，不能替代基础 gzip 功能。
在 http 块中配置核心参数
所有配置必须写在 http { } 块内（不是 server 或 location），否则不生效。推荐配置如下：
- gzip on; —— 必须开启，全局启用压缩
- gzip_min_length 1024; —— 小于 1KB 的响应不压，避免小文件因压缩头开销反而变大
- gzip_comp_level 5; —— 级别 5 是实测平衡点：压缩率约 68%，CPU 开销可控；级别 6 以上提升有限但 CPU 显著上升，不建议
-
gzip_types —— 显式列出类型，务必包含：
text/plain text/css application/javascript application/json text/xml application/xml+rss image/svg+xml
特别注意：application/json 必须显式写入，否则 API 返回的 JSON 不会被压缩 - gzip_vary on; —— 添加 Vary: Accept-Encoding 响应头，确保 CDN 和代理缓存不混淆
- gzip_http_version 1.1; —— 避免 HTTP/1.0 兼容性问题
避开常见无效操作
- 不要对 JPEG、PNG、WOFF2、MP4、PDF 等二进制格式启用 gzip——它们本身已高压缩，再压几乎不减体积，反而浪费 CPU，甚至导致“越压越大”
- 若站点含 PHP 动态内容（如
index.php输出 JSON 或 HTML），gzip_types 必须包含 application/x-httpd-php，否则 PHP 响应不会被压缩 - 不建议在 location 块里单独开 gzip；如确需局部控制，应在 server 块顶层先定义 gzip on 和完整 gzip_types，再用 location 配合 gzip off 关闭特定路径
验证是否真正生效
用 curl 测试：
curl -H "Accept-Encoding: gzip" -I https://yoursite.com/api/data.json查看响应头中是否含：
Content-Encoding: gzipVary: Accept-Encoding
若缺失 Content-Encoding，说明配置未命中或 MIME 类型未匹配；若缺失 Vary，缓存可能出错。
