nginx 默认不支持 sse 推送，必须显式关闭缓冲、延长超时、透传头并禁用缓存；漏掉任意一项，eventsource 就会断连或延迟。
直接说结论：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 关闭时仍错误启用分块传输，反而干扰流式解析。
linux-sysadmin
下载
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
- 必须设置
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 参数
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
