Nginx 反向代理缓冲机制与流式接口(SSE)排障记录
今天调一个实时推送进度的 Server-Sent Events 接口,本地直连后端每一秒都能吐一行,挂上 Nginx 以后变成攒够十几秒才哗啦一下全蹦出来。查文档确认是默认开启的 proxy_buffering on 攒够了缓冲区才往下游刷。
不想一刀切关掉整个 location 的缓冲(普通接口开着缓冲可以保护慢客户端不占死后端 worker),最干净的办法是由后端按响应单独返回头控制:
Content-Type: text/event-stream; charset=utf-8
Cache-Control: no-cache
X-Accel-Buffering: no
Nginx 认到 X-Accel-Buffering: no 会自动只对当前这一个响应关闭代理缓冲。另外别忘了检查上层是不是还套了 gzip 压缩或者长连接超时(proxy_read_timeout 默认只有 60s,空闲无心跳时会被掐断)。