Nginx对自定义流式响应（如SSE、JSON流）做Gzip压缩需显式配置gzip_types包含对应MIME类型（如text/event-stream、application/x-ndjson）、启用proxy_buffering、设置gzip_min_length≥1024防碎片压缩，并确保后端未设Content-Encoding或no-transform头，通过curl或浏览器Network面板验证Content-Encoding: gzip生效。
Nginx 对自定义响应数据流（如动态生成的 JSON、SSE、长连接流式响应、Chunked Transfer-Encoding 响应等）做 Gzip 压缩，不是自动适配的，必须满足几个关键前提：响应类型在 gzip_types 中、未被禁用、内容长度达标、且 Nginx 能正确识别并接管该响应体的输出流程。
以下配置要点直击“自定义数据流”场景的核心需求：
响应类型必须显式加入 gzip_types
Nginx 默认只压缩 text/html，其他 MIME 类型（如 application/json、text/event-stream、application/x-ndjson、text/plain;charset=utf-8）需手动声明：
gzip_types text/plain application/json application/javascript text/css text/xml application/xml text/event-stream # 支持 SSE 流式响应压缩 application/x-ndjson # 如日志流、行分隔 JSON text/plain;charset=utf-8; # 注意：含参数的 type 需完整写出
⚠️ 不要写 */* 或 application/* —— Nginx 不支持通配符匹配子类型，必须逐个列出。
确保响应体可被 gzip 过滤器捕获
Nginx 的 gzip 模块通过 ngx_http_gzip_body_filter 在响应体过滤链中工作。对自定义流式响应（如后端用 Transfer-Encoding: chunked 或 Content-Length 动态生成），需保证：
- 后端未设置
Content-Encoding: gzip（否则 Nginx 会透传，跳过压缩） - 后端未返回
Cache-Control: no-transform（该头会禁止 Nginx 修改编码） -
proxy_buffering保持开启（默认 on），否则部分流式响应可能绕过 body filter
若使用 proxy_pass，建议加一句：
location /api/stream {
proxy_pass http://backend;
proxy_buffering on; # 必须启用，确保响应体走完整过滤链
proxy_http_version 1.1;
}控制压缩触发条件，避免小流误压
自定义数据流常以小块（如每秒推送几 KB）持续发送，若每次 chunk 都尝试压缩，开销大且无效。推荐设置合理阈值：
gzip_min_length 1024; # 小于 1KB 的单次 buffer 不压缩（防碎片化压缩） gzip_comp_level 4; # 平衡 CPU 与压缩率，流式场景不建议用 9 gzip_buffers 16 8k; # 分配足够缓冲区应对连续 chunk 输入
? 提示：Nginx 是流式压缩——它把收到的多个 upstream buffer 汇总进 zlib 输入流，按需 flush；只要响应未结束（无
last_buf），上下文状态就保留，适合长连接流。
验证是否真正生效
不要只看最终响应头，要检查实际数据流行为：
- 用
curl -H "Accept-Encoding: gzip" -s -w "%{size_download}\n" -o /dev/null URL对比未压缩大小 - 在浏览器 Network 面板查看某次请求的 Content-Encoding: gzip 是否存在，且 Transfer Size 显著小于 Size
- 若是 SSE，可用
curl -N观察是否仍能实时收到解压后的 event（现代浏览器自动处理）
特殊情况：带编码参数或动态 type 的响应
某些框架返回 Content-Type: application/json; charset=utf-8，而 gzip_types 中只写了 application/json —— Nginx 默认不匹配带参数的类型。解决方式有两个：
- 在
gzip_types中补全：application/json; charset=utf-8 - 或统一让后端省略 charset（更规范），因为 JSON 标准规定 UTF-8 为默认编码
不复杂但容易忽略。
