Nginx 中怎么排查开启 proxy_buffering 后 SSE 消息推送延迟故障-Nginx-PHP中文网

核心是验证nginx是否拦截sse数据：检查响应头是否为text/event-stream且未被篡改；确认proxy_buffering off已精准配置在sse路径location块中并配齐proxy_cache off、proxy_read_timeout 86400等；抓包观察data:是否实时发出。

nginx 中怎么排查开启 proxy_buffering 后 sse 消息推送延迟故障

排查开启 proxy_buffering 后 SSE 消息延迟，核心是验证数据是否被 Nginx 拦在缓冲区里没发出去——不是后端没推，而是代理卡住了。重点看三点：响应头是否合规、缓冲是否真关闭、连接是否被意外中断。

确认 SSE 响应头是否正确且未被覆盖

SSE 要生效，后端必须返回标准的流式响应头，Nginx 不能篡改或缺失关键字段：

Content-Type 必须是 text/event-stream，不能是 application/json 或 application/octet-stream；用 curl -v http://your-domain/sse 直接测，检查响应头
Nginx 默认可能重写 Connection 或 Transfer-Encoding 头，需显式保留：
proxy_set_header Connection '';
chunked_transfer_encoding on;
避免 gzip 压缩干扰：SSE 不支持压缩，务必在对应 location 中加 gzip off;

验证 proxy_buffering 是否真正关闭（仅对路径生效）

全局关 proxy_buffering off 是错的，但只写这一行也不够——它必须出现在正确的 location 块中，并且配套参数同步到位：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

检查配置是否落在 SSE 路径下，例如：
location ^~ /api/events {
proxy_pass http://backend;
proxy_buffering off; ← 这一行必须存在且未被其他块继承覆盖
用 nginx -T | grep -A10 "location.*events" 确认实际生效的完整配置块
加 add_header X-Accel-Buffering no;，让浏览器和调试工具能明确看到 Nginx 已放弃缓冲

检查超时与连接状态是否导致“假延迟”

SSE 是长连接，Nginx 默认 60 秒无数据就断连，前端重连会造成几秒空白，看起来像消息延迟：

必须设 proxy_read_timeout 86400;（24 小时）或至少匹配业务最长空闲时间
同步配 proxy_send_timeout 86400; 和 keepalive_timeout 86400;，防止发送阶段或客户端侧断连
查看 Nginx error.log，搜索 upstream prematurely closed connection 或 client timed out，这类日志直接指向超时问题