Nginx空Accept-Encoding导致请求超时问题求助

我在Nginx反向代理中需要替换响应内容里的字符串，初始配置如下：

sub_filter 'https://upstream.com' 'http://www.localhost:8080';
sub_filter_once off;

但上游返回的响应是压缩状态，导致sub_filter无法生效。于是我添加了以下配置来禁用压缩：

proxy_set_header Accept-Encoding "";

结果出现网关超时错误。但用Postman设置空Accept-Encoding头请求上游服务器能正常访问，说明问题出在Nginx配置上。完整配置如下：

worker_processes  1;

events {
    worker_connections  1024;
}

http {
    server {
        listen       8080;
        server_name  localhost;

        location / {
            proxy_pass https://www.upstream.com;
            proxy_hide_header 'x-frame-options';
            proxy_cookie_domain ~^(.*)$ "http://www.localhost:8080";
            proxy_set_header X-Real-IP $remote_addr;
            proxy_cookie_path / "/; secure; HttpOnly; SameSite=none";
            sub_filter 'https://www.upstream.com' 'http://www.localhost:8080';
            sub_filter_once off;
            sub_filter_types text/html;
            proxy_set_header Accept-Encoding "";
        }
    }
}

注：upstream.com仅为示例，实际使用其他URL。

解决办法 #

方法一：修正空Accept-Encoding头的配置 #

当前设置空头的写法可能导致格式异常，把proxy_set_header Accept-Encoding "";改成：

proxy_set_header Accept-Encoding '';

这种写法更符合Nginx语法规范，避免因引号解析问题导致请求异常。

方法二：让Nginx自动解压并重新压缩响应（推荐） #

不需要去掉Accept-Encoding头，而是让Nginx先解压上游的压缩响应，执行字符串替换后，再根据客户端需求重新压缩返回。添加以下配置即可：

proxy_set_header Accept-Encoding "gzip, deflate";
gunzip on;
gzip on;

修改后的location配置如下：

location / {
    proxy_pass https://www.upstream.com;
    proxy_hide_header 'x-frame-options';
    proxy_cookie_domain ~^(.*)$ "http://www.localhost:8080";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_cookie_path / "/; secure; HttpOnly; SameSite=none";
    sub_filter 'https://www.upstream.com' 'http://www.localhost:8080';
    sub_filter_once off;
    sub_filter_types text/html;
    
    # 处理压缩响应的配置
    proxy_set_header Accept-Encoding "gzip, deflate";
    gunzip on; # 解压上游的gzip响应
    gzip on; # 重新压缩后返回给客户端
}

这种方式既能让sub_filter正常工作，又不影响上游的压缩策略，同时保持对客户端的压缩支持，避免性能损耗。

额外排查点 #

• 用nginx -V命令检查是否加载了ngx_http_gunzip_module模块，编译参数里要有--with-http_gunzip_module。
• 如果上游用的是Brotli（br）压缩，需要额外安装并配置ngx_http_brotli_module才能处理。

内容的提问来源于stack exchange，提问作者Jonathan Daniel