Nginx 怎么排查 Nginx 开启 Brotli 后由于不支持该编码的客户端导致的降级异常-Nginx-PHP中文网

nginx开启brotli后降级异常，本质是accept-encoding协商失配：需确保同时启用gzip与brotli、types范围一致、禁用干扰指令（如gzip_disable）、避免map/if误关gzip，并通过curl模拟客户端及日志记录$http_accept_encoding与$sent_http_content_encoding验证协商结果。

nginx 怎么排查 nginx 开启 brotli 后由于不支持该编码的客户端导致的降级异常

Nginx 开启 Brotli 后，若客户端不支持 br 编码却未正确降级到 gzip 或明文，就会出现响应异常（如 ERR_CONTENT_DECODING_FAILED、空白页、JSON 解析失败等）。这类问题不是 Nginx 自身报错，而是协议协商失配导致的静默故障，排查需聚焦「请求特征→编码协商→响应生成」全链路。

确认是否真存在降级异常
先验证现象是否属于降级失败：

用不支持 Brotli 的客户端测试（如旧版 Safari、IE11、curl 不带 Accept-Encoding: br）
检查响应头中 Content-Encoding 字段：若为 br，但客户端不支持，即属降级失效
对比同一资源在 Chrome（支持 br）和 Firefox 78（不支持 br）下的响应头差异

检查 Accept-Encoding 协商逻辑是否被干扰
Brotli 降级依赖客户端真实声明的 Accept-Encoding，常见干扰点：

反向代理或 CDN 清除了该请求头（如 Cloudflare 默认会改写或限制）
Nginx 配置中误用了 proxy_set_header Accept-Encoding "" 或 proxy_pass_request_headers off
上游服务（如 Node.js/PHP）手动设置了 Content-Encoding: br，绕过 Nginx 压缩决策

验证 gzip 作为兜底是否启用且生效
Brotli 和 gzip 必须共存，且 gzip 要在 Brotli 不匹配时自动接管：

确保配置中同时存在 gzip on 和 brotli on，二者不互斥
gzip_types 和 brotli_types 覆盖范围应一致（如都包含 application/json text/css）
不要设 gzip_disable "msie6" 等过于激进的禁用规则，避免老浏览器连 gzip 都拿不到

检查 Nginx 是否因条件判断跳过了 gzip 回退
常见错误是用 map 或 if 错误覆盖了默认行为：

避免在 location /api/secure/ 中只写 brotli on 却没配 gzip on
若用了 map $http_accept_encoding $use_brotli { ~*br 1; default 0; }，需确保后续逻辑未屏蔽 gzip：
```
gzip on;
brotli on;
# 不要用 if ($use_brotli = 0) { gzip off; } —— 这会关掉所有压缩
```

抓包验证实际协商结果
终端直接访问 Nginx（绕过 CDN/代理），用 curl 模拟不同客户端：

# 模拟不支持 br 的客户端
curl -H "Accept-Encoding: gzip, deflate" -I https://yoursite.com/api/data

# 模拟明确拒绝 br 的客户端（部分旧工具会这样发）
curl -H "Accept-Encoding: gzip" -I https://yoursite.com/api/data

# 查看响应头是否为 Content-Encoding: gzip 或无该头

若返回 Content-Encoding: br，说明 Nginx 未识别 Accept-Encoding 中无 br，可能因：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

map 规则写错（如正则漏了 .* 匹配空值）
$http_accept_encoding 变量为空时 default 分支未生效

日志中添加关键字段辅助定位
在 log_format 中加入协商与响应信息：

log_format debug '$remote_addr - $remote_user [$time_local] '
                  '"$request" $status $body_bytes_sent '
                  '"$http_accept_encoding" "$sent_http_content_encoding"';

查看日志可快速发现：