现象
按教程编译了 brotli 模块,nginx.conf 里写了 brotli on,nginx -t 也没报错,可浏览器开发者工具里 JS 文件的 Content-Encoding 仍然是 gzip。用 curl 带上 accept-Encoding: br 请求,返回的体积和 gzip 几乎一样,压缩率并没有变好。
原因
最常见的是 brotli_types 没配,它的默认值只有 text/html,css 和 js 根本不在压缩范围内。其次是动态模块没有 load_module,指令被忽略却不影响启动检查。还有一种情况是 gzip 和 brotli 同时开启,浏览器优先报 br,但 Nginx 先命中了 gzip 规则,或者文件体积小于 brotli_min_length 默认的 2048 字节,直接跳过压缩。
解决步骤
第一步,确认模块真的加载了。用 nginx -V 看编译参数里有没有 brotli,动态加载的话检查 load_module 的路径是否正确。
nginx -V 2>&1 | grep -o brotli
nginx -T | grep -E "brotli|gzip"
curl -sI -H "Accept-Encoding: br" https://example.com/app.js
第二步,把类型列表补全。在 http 或 server 块里写 brotli_types text/css application/javascript application/json image/svg+XML,把 brotli_comp_level 设成 5,兼顾 CPU 与压缩率;小文件保留 gzip 即可。
第三步,确认响应头真的变了。重载后再次请求静态资源,看 Content-Encoding 是否为 br,同时对比 Content-Length 与源文件大小,算出实际压缩比。
验证
响应头返回 Content-Encoding: br,app.js 从 240KB 降到 62KB 左右,比 gzip 再小两成,Lighthouse 里文本压缩项变成通过。
小结
Brotli 不生效基本逃不出类型没配、模块没加载、被 gzip 抢先三种原因。先查 nginx -T 的实际生效配置,再补类型和最小长度,最后用响应头验证。
