Nginx默认不透传Accept-Encoding头，需用proxy_set_header Accept-Encoding $http_accept_encoding;显式配置，并关闭gzip off;、gunzip off;以避免干扰后端压缩逻辑。
默认情况下，Nginx 不会自动将客户端请求中的 Accept-Encoding 头转发给上游服务器（如后端应用），尤其在启用代理（proxy_pass）时。若后端需根据该头决定是否返回 gzip/br 压缩响应，必须显式配置透传。
确保 Accept-Encoding 正确透传
Nginx 默认会清除或重写部分请求头，Accept-Encoding 就是其中之一（尤其当启用了 gzip 或 gunzip 指令时）。要让它原样传递，需在 location 或 server 块中明确设置：
- 使用
proxy_set_header Accept-Encoding $http_accept_encoding;—— 这会把客户端原始值赋给上游请求头 - 避免同时开启
gzip on;和反向代理到支持压缩的后端，否则 Nginx 可能提前解压响应，干扰后端压缩逻辑 - 若 Nginx 本身不处理压缩（即仅做透传），建议关闭其压缩模块相关指令：
gzip off;、gunzip off;
验证是否生效
可在后端服务（如 Node.js、Python Flask）中打印请求头，检查是否收到 Accept-Encoding: gzip, deflate, br 等值。也可用 curl 模拟并配合 -v 查看 Nginx 发出的上游请求头：
curl -H "Accept-Encoding: br,gzip" -v http://your-nginx-domain/api
注意观察 `* Connected to ...` 后的 `> Accept-Encoding:` 行是否与原始一致。
常见干扰项：gzip_vary 和 proxy_hide_header
以下配置可能意外影响 Accept-Encoding 透传：
-
gzip_vary on;会自动添加Vary: Accept-Encoding响应头，但不影响请求头透传，可保留 -
proxy_hide_header Accept-Encoding;—— 绝对不能加，这是响应头过滤指令，误用会导致上游收不到该头 -
proxy_pass_request_headers off;—— 全局禁用请求头转发，必须设为on（默认值，一般无需显式写）
特殊场景：强制透传或改写
如果后端只认特定值（比如只处理 gzip），可用 map 指令标准化：
map $http_accept_encoding $accept_encoding_upstream {
default "";
"~*gzip" "gzip";
"~*br" "br";
}
# 然后在 location 中：
proxy_set_header Accept-Encoding $accept_encoding_upstream;但多数情况推荐保持原始值透传，由后端自主决策更合理。
