核心是验证「请求→nginx查找→响应」链路断点：检查.br文件是否存在、路径是否匹配root/alias、权限是否允许nginx用户读取、brotli_types是否包含对应mime类型（如text/html）、brotli_static是否在http/server块显式启用且未被覆盖。
排查因缺少 .br 文件导致的 Brotli 降级，核心是验证「请求 → Nginx 查找 → 响应」链路中哪一环断开。不是看配置开了没，而是看 .br 文件是否存在、是否可读、是否被正确匹配。
确认 .br 文件是否真实存在且路径匹配
Nginx 的 brotli_static on 或 always 不会生成文件，只做查找。它严格按请求 URI 拼接 .br 后缀去物理路径找文件。
- 比如浏览器请求
/assets/app.abc123.js，Nginx 会尝试读取/var/www/dist/assets/app.abc123.js.br（路径由root或alias决定） - 用
ls -l手动检查该路径下对应.br文件是否存在、权限是否允许 Nginx worker 用户（如www-data或nginx）读取 - 特别注意构建工具（如 Vite/webpack）是否真的输出了
.br文件——有些插件默认只压.gz，需显式指定algorithm: 'brotliCompress'和ext: '.br'
检查 Nginx 是否实际命中了 .br 文件
仅靠响应头 Content-Encoding: br 不够，要确认它是来自静态文件直读，而非动态压缩（后者说明 .br 缺失或未启用）。
- 打开 Chrome DevTools → Network → 刷新页面 → 点击一个 JS/CSS 请求
- 查看 Response Headers 中的
Content-Encoding：是br，但还需看Content-Length是否明显小于原始文件（如app.js是 280KB，app.js.br应在 90–110KB 左右） - 若
Content-Length接近原始大小，或响应时间略高（>5ms），大概率是 fallback 到了动态压缩，说明.br文件缺失或未被找到
验证 brotli_static 行为是否生效
brotli_static 默认是 off，即使开了 brotli on 也不会触发静态查找。必须显式开启，并注意其行为差异：
-
brotli_static on;：仅当请求头含Accept-Encoding: br且存在.br文件时才返回；否则退回到原始文件（不压缩） -
brotli_static always;：只要存在.br文件就返回，不管客户端是否声明支持 —— 更激进，适合全量现代用户场景 - 检查配置是否写在
http{}或server{}块内，且没有被更内层的location覆盖或重置 - 运行
nginx -t确保语法无误，再nginx -s reload生效
排查静默失败的常见盲区
缺少 .br 文件时，Nginx 不报错、不打 warning 日志，只会安静地返回未压缩内容。容易忽略的细节包括：
-
MIME 类型不匹配：Nginx 只对
brotli_types列出的类型查找.br。如果text/html没写进去，首页index.html.br就永远不被查 -
root/alias 路径偏差：例如
location /static/ { alias /data/static/; }，请求/static/main.css会查/data/static/main.css.br；但若误配成root /data/static;，就会查/data/static/static/main.css.br（多了一级static） -
文件权限或 SELinux 限制：
ls -Z查看 SELinux 上下文，或临时setenforce 0测试是否被拦截
