gzip 开了响应还是明文:Accept-Encoding 和 MIME 谁配错了

接口返回 300 多 KB 的 JSON,开了 gzip 但 curl 一看没有 content-encoding。运维说配置里明明写了 gzip on。

curl -sI -H "Accept-Encoding: gzip" \
  https://api.example.com/v1/list | grep -i -E \
  "content-encoding|content-type|vary"

响应头里只有 content-type: application/json,没有编码。先确认请求确实带了 accept-Encoding,再看 nginx -T 里实际生效的配置,别只看某个 include 文件。

问题一,gzip_types 只写了 text/html,application/json 不在列表里。nginx 默认只压 text/html,其他类型必须显式列出。问题二更隐蔽,静态目录下有个 .json 文件被 default_type 定成了 application/octet-stream,MIME 不对,类型加对了也匹配不上。

补上类型,min_length 设 1024,vary 打开,级别用 5,CPU 和体积比较平衡。

gzip on;
gzip_types application/json application/javascript text/css;
gzip_min_length 1024;
gzip_vary on;
gzip_comp_level 5;

如果源站已经压过,反代再压会出问题,得看上游有没有 content-encoding。CDN 那一层也要查,有的厂商默认把 Accept-Encoding 剥掉再回源,源站看到的请求不带压缩,怎么配都不生效。用 curl 直接打源站 IP 对比一次,能立刻分清是源站还是 CDN。

实测那个 320KB 的 JSON 压到 28KB,首屏接口耗时从 480ms 降到 210ms,主要省在传输上。图片和 mp4 不要加进 gzip_types,压不了多少,白烧 CPU,类型列表里也别写通配符,nginx 不认。压完记得看 Vary,少了这个头,中间缓存可能把压缩版发给不支持的客户端。

您可以还会对下面的文章感兴趣: