Nginx反向代理Spring WebFlux时流式响应异常问题咨询

Nginx反向代理默认开启的代理响应缓冲机制是导致Flux流无法实时返回的核心原因。默认配置下Nginx不会把后端逐块返回的响应立刻转发给客户端，而是先存入内存/磁盘缓冲区，直到整个响应接收完成、或缓冲区写满后才统一发送，完全破坏了NDJSON流的逐块输出特性。
直连应用时请求直接打到Spring Boot内置的Netty/Tomcat服务器，服务端不会对Flux响应做额外缓冲，每生成一个就绪对象就立刻刷出到客户端，因此表现正常。

1. 核心配置调整 #

在对应反向代理的location块中添加以下配置，关闭代理缓冲、开启即时转发：

location / {
    proxy_pass                    http://localhost:8082;
    proxy_pass_request_headers    on;
    # 建议放开你注释的基础头配置，避免后端服务解析请求异常
    proxy_set_header    Host                $http_host;
    proxy_set_header    X-Real-IP           $remote_addr;
    proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
    proxy_set_header    X-Forwarded-Proto   $scheme;

    # 以下是流式响应必须的配置
    proxy_buffering off; # 关闭代理响应缓冲，核心配置
    proxy_cache off; # 关闭代理缓存
    proxy_http_version 1.1; # 反向代理使用HTTP/1.1协议，支持分块传输
    proxy_set_header Connection ""; # 清理Connection头，适配长连接分块传输
    chunked_transfer_encoding on; # 开启分块传输编码
    tcp_nodelay on; # 禁用Nagle算法，小包立刻发送
}

2. （可选）单独为流式接口配置规则 #

如果不希望全站关闭代理缓冲（代理缓冲对普通静态接口、页面请求有性能提升），可以单独为/flux接口写独立的location规则：

location /flux {
    proxy_pass http://localhost:8082/flux;
    proxy_pass_request_headers on;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    proxy_buffering off;
    proxy_cache off;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    chunked_transfer_encoding on;
    tcp_nodelay on;
}

3. Cloudflare层补充检查 #

你当前链路走了Cloudflare代理，虽然目前Nginx日志的延迟现象说明问题出在Nginx层，但如果Nginx配置修改完成后仍存在响应攒批的情况，需要到Cloudflare控制台对应域名的规则配置中，关闭响应缓冲（Response Buffering） 功能，Cloudflare默认也会对小体积响应做缓冲，同样会阻断流式输出。

4. 配置生效验证 #

修改完Nginx配置后，先执行命令检查配置语法正确性：

nginx -t

确认语法无报错后，执行重载命令让配置生效：

nginx -s reload

重载完成后重新调用接口，即可恢复和直连一致的效果：1秒左右收到第一个返回对象，后续对象逐块推送，总耗时20秒左右完成全量接收。

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