Brotli压缩本身不会导致乱码，乱码源于Content-Encoding、Content-Type与charset三者不匹配；需验证模块编译、响应头、解压有效性、charset显式声明、HTTPS协商、CDN干扰及.br文件路径权限。
Brotli 压缩本身不会直接导致乱码，所谓“乱码”其实是浏览器拿到响应后无法正确解码或渲染——根本原因在于 Content-Encoding、Content-Type 和字符编码（charset）三者不匹配，Brotli 只是把问题放大了。排查要聚焦在“头声明什么、体是什么、浏览器怎么读”这三层是否对齐。
确认 Brotli 真正生效且响应体合法
很多“乱码”实际是白屏或下载弹窗，说明响应体根本没被当文本处理。先验证基础链路是否通：
- 运行
nginx -V 2>&1 | grep brotli，确保输出含--with-http_brotli_module；若无，模块未编译，所有 Brotli 配置无效 - 用
curl -I -H "Accept-Encoding: br" https://yoursite.com/index.html检查响应头：必须同时出现Content-Encoding: br和Content-Type: text/html - 再执行
curl -H "Accept-Encoding: br" https://yoursite.com/index.html | brotli -d -t 2>/dev/null || echo "invalid br"，验证响应体能否被真正解压；失败说明 Nginx 返回了未压缩内容却误加了br头，或 .br 文件损坏
检查 Content-Type 与 charset 是否一致且显式声明
Brotli 不改变 MIME 类型逻辑，但若 Content-Type 缺少 charset=utf-8，浏览器可能按 ISO-8859-1 解析 UTF-8 的 HTML，中文就变方块或问号：
- 对比
curl -I https://yoursite.com/index.html和curl -I https://yoursite.com/index.html.br的Content-Type：两者必须完全相同（如都是text/html; charset=utf-8），不能一个带 charset 一个不带 - 确保 Nginx 配置中启用了
charset utf-8;（放在 http 或 server 块），并补充charset_types text/html text/css application/javascript; - 避免在 location 中使用
default_type text/plain;或覆盖types映射，否则.html.br可能被当成application/octet-stream返回
排除 HTTPS 协商与 CDN 干扰
Brotli 只在 HTTPS 下由现代浏览器主动发起协商；HTTP 站点永远不触发，强行配置会导致 fallback 失效或头体错配：
- 用 Chrome DevTools Network 标签页查看 index.html 请求：响应头必须有
Content-Encoding: br和Vary: Accept-Encoding，且 “Size”（传输体积）明显小于 “Content”（解压后体积） - 若使用 CDN（如 Cloudflare、阿里云全站加速），它可能回源时带
Accept-Encoding: br, gzip，但自身不支持 Brotli 解压。可在 Nginx 中用map清空 CDN 回源请求的编码头：map $http_user_agent $disable_accept_encoding { ~*(Cloudflare|AliYun) 1; default 0; }<br>map $disable_accept_encoding $accept_encoding { 1 ""; default $http_accept_encoding; }
然后在 proxy_pass 前设proxy_set_header Accept-Encoding $accept_encoding;
验证静态 .br 文件路径与权限是否严格匹配
Nginx 的 brotli_static on 是硬匹配机制：不生成、不转换、只查找。路径错一点或权限不足，就会 fallback 到未压缩 HTML，而如果此时又漏了 charset，乱码就出现了：
- 确认磁盘上存在同名 .br 文件，且与原始文件在同一目录、权限可读：
ls -l /usr/share/nginx/html/index.html.br -
brotli_static on;必须写在具体 location 块内（如location ~ \.html$），不能只放在 http 块里 - 若同时启用
gzip_static，Brotli 优先；但若 Brotli 失败且未配 gzip fallback，浏览器可能收到裸 HTML 却因 header 残留被误判为 br 流，直接丢弃
