nginx转发SSE时连接频繁中断如何解决？

Question

在使用 Nginx 作为反向代理转发 Server-Sent Events（SSE）连接时，经常出现连接频繁中断的问题。该问题通常由 Nginx 默认的超时设置或缓冲行为引起。SSE 连接需保持长时间打开，而 Nginx 默认的 proxy_read_timeout、proxy_send_timeout 等参数过短，或启用了缓冲（buffering），导致连接被提前关闭或数据未能及时传输。此外，HTTP/1.0 协议版本或不正确的 Upgrade 和 Connection 头配置也会造成连接中断。解决方法包括：调整 proxy_read_timeout 和 proxy_send_timeout 至较大值或设为 0（无超时），禁用 proxy_buffering，确保正确设置 Upgrade 和 Connection 头以支持长连接。

Answer 1

1. 初识问题：Nginx 反向代理下的 SSE 连接中断

在使用 Nginx 作为反向代理来转发 Server-Sent Events（SSE）连接时，开发者常常会遇到连接频繁中断的问题。这种现象通常与 Nginx 的默认配置有关，尤其是在处理长连接和流式数据传输方面。

SSE 是一种允许服务器向客户端推送实时更新的技术，其特点是保持 HTTP 连接长时间打开。而 Nginx 默认的超时设置（如 proxy_read_timeout 和 proxy_send_timeout）较短，容易导致连接被提前关闭。

2. 深入剖析：常见导致 SSE 中断的原因

以下是从技术角度分析导致 SSE 连接中断的主要原因：

• proxy_read_timeout / proxy_send_timeout 设置过短：默认值为 60 秒，SSE 连接若超过该时间无数据传输，将被强制关闭。
• proxy_buffering 启用：启用缓冲会导致 Nginx 缓存响应内容，延迟发送给客户端，破坏了 SSE 的即时性。
• HTTP/1.0 协议版本使用：HTTP/1.0 不支持 keepalive，无法维持长连接。
• Upgrade 和 Connection 头未正确设置：这些头信息用于指示协议升级或维持连接状态，缺失或错误配置会导致连接异常终止。

3. 解决方案：优化 Nginx 配置以支持 SSE

为解决上述问题，需对 Nginx 的代理配置进行如下调整：

配置项	推荐值	说明
proxy_read_timeout	86400s 或 0	设置为一天或 0（无超时），确保连接不因读取超时而中断。
proxy_send_timeout	86400s 或 0	防止因写入超时而断开连接。
proxy_buffering	off	禁用缓冲，保证数据即时传输。
proxy_http_version	1.1	使用 HTTP/1.1 支持长连接。
proxy_set_header Upgrade $http_upgrade	添加该行	支持协议升级。
proxy_set_header Connection "upgrade"	添加该行	维持连接状态。

4. 实际应用：完整 Nginx 配置示例

以下是一个适用于 SSE 场景的 Nginx 配置片段：

location /sse/ {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 86400s;
    proxy_send_timeout 86400s;
}
  

此配置可有效延长连接生命周期，避免因超时或缓冲机制导致的数据传输中断。

5. 架构视角：SSE 在现代系统中的定位

从架构设计角度看，SSE 是实现服务端推送的一种轻量级替代方案，特别适合事件驱动型应用场景，如通知系统、实时仪表盘等。

相较于 WebSocket，SSE 更简单易用，且兼容性更好；但在复杂交互场景中可能不如 WebSocket 灵活。

使用 Nginx 作为反向代理时，合理配置是保障 SSE 正常工作的关键。

下图展示了 SSE 请求在 Nginx 转发过程中的典型流程：

graph LR
    A[Client] -- 发起 SSE 请求 --> B[Nginx]
    B -- 转发请求 --> C[后端服务]
    C -- 返回流式数据 --> B
    B -- 流式返回 --> A