Linux下Nginx配置SSE推送与长连接参数设置

在 Linux 下使用 Nginx 代理 SSE（Server-Sent Events）时，看似简单的长连接推送极易因配置疏漏而失败——默认设置会导致 60 秒断连、消息延迟卡顿、跨域失效或内存暴涨等生产级问题；真正可靠的支持必须显式关闭 proxy_buffering、大幅调高 proxy_read_timeout 和 keepalive_timeout、透传关键响应头（如 Content-Type 和 CORS 头）、禁用 Nginx 缓冲干扰，并协同后端发送心跳与云厂商负载均衡器超时设置；漏掉任一环节，EventSource 就会静默重连或完全失活，这篇文章直击 SSE 在 Nginx 上落地的全部核心陷阱与可立即生效的硬核配置方案。

直接说结论：Nginx 默认不支持 SSE 推送，必须显式关闭缓冲、延长超时、透传头，并禁用缓存——漏掉任意一项，EventSource 就会断连或延迟。

为什么 EventSource 连接总在 60 秒后断开

这是最常见现象，浏览器控制台可能看不到报错，但 Network 面板里 SSE 请求状态码是 200，却反复重连。根本原因是 Nginx 的 proxy_read_timeout 默认值为 60 秒，超时后主动关闭连接，而 SSE 要求连接长期存活。

• proxy_read_timeout 必须设为远大于客户端预期事件间隔（例如设 86400 表示 24 小时）
• keepalive_timeout 也要同步调高（如 keepalive_timeout 86400），否则底层 TCP 连接会被内核回收
• 注意：proxy_read_timeout 控制“从后端读数据的等待时间”，不是“连接空闲多久断开”；keepalive_timeout 才是控制“HTTP keep-alive 连接复用的最大空闲时间”
• 若你用的是云厂商 LB（如阿里云 SLB、腾讯云 CLB），它们自身也有独立的空闲超时（常为 60~300 秒），需一并调整，否则 Nginx 配置再对也白搭

data: 消息迟迟不显示？检查 proxy_buffering 和 chunked_transfer_encoding

SSE 数据以 data: hello\n\n 格式逐块输出，但 Nginx 默认开启 proxy_buffering on，会攒够 4KB 或等响应结束才转发，导致前端“卡住”。同时某些 Nginx 版本在 buffering 关闭时仍错误启用分块传输，反而干扰流式解析。

• 必须设置 proxy_buffering off —— 这是 SSE 实时性的底线
• chunked_transfer_encoding 建议显式设为 on（尤其 Nginx ≥ 1.13.6），确保服务端分块能被正确透传；旧版本可设 off 避免自动封装，但前提是后端自己输出正确的 Transfer-Encoding
• 务必加 proxy_hide_header X-Accel-Buffering，防止 Nginx 注入 X-Accel-Buffering: yes 头误导浏览器
• 后端必须返回 Content-Type: text/event-stream，Nginx 不应覆盖它；若后端漏设，才用 add_header Content-Type "text/event-stream" 补充

跨域请求失败：Access-Control-Allow-Origin 不能只靠后端

即使后端已返回 Access-Control-Allow-Origin: *，Nginx 仍可能屏蔽该头——默认会过滤掉非标准响应头。更关键的是，SSE 的预检（OPTIONS）请求不会触发，浏览器直接发 GET，所以 CORS 头必须由代理层稳定提供。

• 用 add_header Access-Control-Allow-Origin "*" 直接注入，比依赖后端更可靠
• 若前端 EventSource 设了 { withCredentials: true }，则 Access-Control-Allow-Origin 不能为 *，必须写具体域名（如 https://example.com），且要加 add_header Access-Control-Allow-Credentials "true"
• add_header 在 location 块里生效，不要放在 server 或 http 块顶层，避免污染普通接口
• 别忘了 proxy_pass_request_headers on，让后端能读取原始 Origin 头做动态判断（如需白名单校验）

生产环境容易忽略的三个硬伤

配置写完 reload，看似能跑，但压测或上线后出问题，往往卡在这三处：

• Nginx worker 进程内存暴涨：大量 SSE 连接下，每个连接占用约 16–32KB 内存。若并发 10 万连接，仅连接结构体就吃掉 1.6–3.2GB。需调高 worker_connections 并限制 events { use epoll; worker_connections 65535; }，同时确认系统 ulimit -n 足够（建议 ≥ 100000）
• 后端未发送心跳：SSE 连接空闲超时不仅发生在 Nginx 层，浏览器 EventSource 也有默认超时（Chrome 约 5 分钟）。后端必须定期输出注释行（如 :heartbeat\n\n）或空 data 行，维持连接活跃
• 日志里出现 upstream timed out (110: Connection timed out)：说明后端处理慢或挂起，不是 Nginx 配置问题。此时要查后端是否阻塞在 IO、数据库查询或锁上，而非继续调 Nginx 参数

本篇关于《Linux下Nginx配置SSE推送与长连接参数设置》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！