Nginx中Brotli压缩不处理字符编码，乱码根源在于Content-Type缺失charset、BOM/非法字节、代理篡改协商头或HTTP协议下未触发br协商；必须显式设charset utf-8、精准配置brotli_types、透传Accept-Encoding与Vary头，并仅在HTTPS下生效。
Nginx 中 Brotli 压缩本身不处理字符编码，它只对响应体做无损压缩；字符编码（如 UTF-8、GBK）由 Content-Type 头中的 charset 参数声明，与压缩无关。所谓“多语言站点的字符编码与压缩冲突”，实际是配置不当引发的乱码、406 错误或解压失败，根源不在 Brotli 算法，而在 MIME 类型映射、BOM 干扰、协商头缺失或代理层篡改。
确认 Content-Type 与 charset 是否正确声明
浏览器依赖 Content-Type: text/html; charset=UTF-8 这类完整头来解码 HTML/JS/CSS。若 Nginx 或上游服务漏写 charset，或错误设为 GBK 却返回 UTF-8 内容，即使 Brotli 压缩正常，解压后仍是乱码。
- 检查响应头是否含
charset：用 curl 或 DevTools 查看Content-Type字段 - 在 Nginx 的
http或location块中显式设置：charset utf-8; charset_types text/html text/css application/javascript application/json;
- 避免在
add_header Content-Type中硬编码而不带 charset，这会覆盖上游正确的声明
防止 BOM 和非法字节触发解压失败
UTF-8 BOM（EF BB BF）虽不违法，但部分老旧代理或解析器在解压前校验字节流时可能报错；更常见的是 PHP/Node.js 输出了隐藏的空格、换行或调试信息（如 var_dump() 后的空白），导致响应体开头不是合法 JSON/HTML，Brotli 压缩后仍可传输，但客户端解压后解析失败。
- 对 PHP：确保
.php文件无?>后多余换行；启用output_buffering = On并ob_clean()清理缓冲 - 对 Node.js：检查
res.send()前是否意外调用了console.log()或未捕获异常导致半截响应 - 静态 HTML/JSON 文件可用
file -i index.html验证编码，用xxd -l 16 index.html查看是否有 BOM
代理环境下的 Accept-Encoding 与 Vary 协商必须完整
多语言站点常经 CDN 或反向代理（如 Cloudflare、Nginx → Spring Boot），这些中间层若删掉、改写或未透传 Accept-Encoding，Brotli 就无法协商，而降级逻辑又因 Vary 头缺失失效，最终返回未压缩内容却声明 Content-Encoding: br，或反之。
- 在 Nginx 主配置中强制保留协商头：
add_header Vary "Accept-Encoding, Accept-Language" always;
（注意：
Accept-Language是多语言关键，不能只加Accept-Encoding） - 若使用反向代理，确保透传原始请求头：
proxy_pass_request_headers on; # 不要写 proxy_set_header Accept-Encoding "";
- 测试不同语言+编码组合：
curl -H "Accept-Language: zh-CN,zh;q=0.9" -H "Accept-Encoding: br" -I https://site.com/ curl -H "Accept-Language: es-ES" -H "Accept-Encoding: gzip" -I https://site.com/
brotli_types 必须匹配多语言资源的真实 MIME 类型
Brotli 不压缩二进制文件，但多语言站点常混用 text/plain（如本地化 .properties）、application/json（i18n 数据包）、text/html; charset=gbk（老中文站）。若 brotli_types 漏掉 text/plain 或错误包含 *，会导致：
- 漏配：
.json返回未压缩，体积翻倍 - 误配：图片被强行 Brotli 压缩，体积变大且解压失败
- 正确做法：
brotli_types text/plain text/html text/css text/javascript application/javascript application/json application/xml+rss image/svg+xml;
不加
text/plain就无法压缩.po、.properties等本地化文本；不加application/json就压不了 i18n API 响应。
HTTPS 是前提，HTTP 下 Brotli 永远不触发
所有现代浏览器仅在 HTTPS 请求中发送 Accept-Encoding: br。如果站点用 HTTP 提供多语言服务（如内网测试环境），无论配置多完善，Content-Encoding: br 绝不会出现——这不是 bug，是规范强制要求。
- 检查协议：用
curl -I http://site.com和curl -I https://site.com对比Accept-Encoding请求头与响应头差异 - 若必须 HTTP 调试，可用 Chrome 启动参数
--unsafely-treat-insecure-origin-as-secure="http://site.com" --user-data-dir=/tmp/test临时启用，但生产环境务必强制 HTTPS
