Nginx中正确配置SSE（Server-Sent Events）服务

让我们深入探讨如何在Nginx中正确配置SSE（Server-Sent Events）服务。SSE是一种基于HTTP的服务器推送技术，需要特殊的Nginx配置来维持长连接。

核心配置要点

1. 代理缓冲与分块传输
   location /sse-endpoint {
   proxy_pass http://backend;
   proxy_buffering off; # 禁用缓冲确保实时性
   proxy_cache off; # 禁用缓存
   chunked_transfer_encoding on; # 启用分块传输
   }

关键作用：proxy_buffering off确保数据立即转发而非缓冲，这对SSE的实时性至关重要。分块传输允许服务器持续发送数据片段。

2. 超时控制
   proxy_read_timeout 3600s; # 后端读取超时（建议1小时+）
   proxy_send_timeout 3600s; # 发送超时
   keepalive_timeout 3600s; # 保持连接时间

最佳实践：SSE连接通常需要长时间保持，建议设置1小时以上。注意这些值需要大于你的预期事件间隔时间。

3. 连接头控制
   proxy_set_header Connection '';
   proxy_http_version 1.1; # 必须使用HTTP/1.1

版本差异：HTTP/1.1是SSE的必要条件，同时清空Connection头防止被转为close。

4. 事件流头设置
   add_header Content-Type 'text/event-stream';
   add_header Cache-Control 'no-cache';

常见问题：缺少正确的Content-Type会导致浏览器不识别SSE流。

常见问题解决方案

连接中断问题排查：

1. 检查Nginx日志中的upstream timed out错误
2. 浏览器开发者工具查看SSE连接状态码
3. 心跳机制：服务端应定期发送注释行（如: heartbeat\n\n）

代理层特殊配置：

针对云环境或LB的特殊配置

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
real_ip_header X-Forwarded-For;

完整配置示例

server {
location /events {
proxy_pass http://sse_backend;
proxy_http_version 1.1;
proxy_set_header Connection '';
proxy_set_header Host $host;

    proxy_buffering off;proxy_cache off;chunked_transfer_encoding on;proxy_read_timeout 24h;keepalive_timeout 24h;add_header Content-Type 'text/event-stream';add_header Cache-Control 'no-cache';add_header Access-Control-Allow-Origin *;
}

}

性能考量：虽然长连接会占用资源，但现代Nginx能高效处理大量空闲连接。建议配合连接数监控（如ngx_http_stub_status_module）来评估服务器负载。