如何让Event Stream（EventSource()）在Cloudflare环境下正常工作？

核心问题定位 #

你的场景是EventServer-Sent Events (SSE) 流式传输在Cloudflare代理层出现协议层面中断，QUIC（HTTP/3）和HTTP/2的协议错误通常和Cloudflare的传输层优化、帧处理或连接复用策略冲突有关，尤其是SSE这种长连接、分块输出的场景。

针对性解决方案 #

1. 强制禁用HTTP/3（QUIC） #

Cloudflare默认启用HTTP/3，但QUIC对长连接流式传输的兼容性存在场景化问题，直接强制回退到HTTP/2或HTTP/1.1：

• 在Cloudflare控制台「网络」选项卡，找到「HTTP/3」开关暂时关闭
• 或添加页面规则，对SSE接口路径设置Disable HTTP/3

2. 细化Cloudflare的SSE专属配置 #

除缓存绕过外，需针对SSE接口禁用Cloudflare其他干扰性特性：

• 添加页面规则，匹配你的SSE接口路径（如/api/stream/*），开启以下设置：
  • 「缓存级别」设为「绕过」
  • 「自动HTTPS重写」关闭
  • 「Rocket Loader」关闭
  • 「HTTP/2 回压」关闭
  • 「WebSockets」开启（虽SSE不是WebSocket，但兼容配置可减少连接中断）

3. 完善后端及Nginx的响应头配置 #

确保后端返回的SSE响应头符合规范，且Nginx透传所有必要头：

• 后端必须返回的响应头：

  Content-Type: text/event-stream
  Cache-Control: no-cache, no-store, must-revalidate
  Connection: keep-alive
  Transfer-Encoding: chunked
  X-Content-Type-Options: nosniff
  

• Nginx除proxy_set_header X-Accel-Buffering no;外，补充配置：

  proxy_http_version 1.1;
  proxy_set_header Connection "";
  proxy_cache off;
  proxy_buffering off;
  proxy_read_timeout 3600s;  # 根据流式时长调整，避免超时断开
  

4. 排查Cloudflare防火墙与安全规则 #

部分安全规则会误判SSE分块输出为异常流量：

• 进入Cloudflare「安全」→「WAF」，临时关闭规则测试是否恢复正常
• 若关闭后正常，逐一排查规则，对SSE接口路径添加「允许」例外规则
• 检查「安全级别」是否过高，暂时调低至「本质无害」测试

5. 验证连接复用问题 #

EventSource默认复用连接，但Cloudflare的连接复用策略可能导致后续帧传输异常：

• 前端初始化EventSource时，添加withCredentials: true（需后端允许跨域凭证）
• 或每次创建新EventSource实例时，在URL后加随机参数（如?t=${Date.now()}），强制建立新连接

验证步骤 #

1. 先关闭HTTP/3，测试是否仍出现QUIC错误
2. 应用页面规则和Nginx配置后，用浏览器开发者工具「网络」面板查看SSE请求：
   • 协议类型（是否为HTTP/2或HTTP/1.1）
   • 响应头是否完全符合要求
   • 传输帧是否被截断
3. 查看Cloudflare「分析」→「流量」面板，确认SSE请求的状态码和错误类型

内容的提问来源于stack exchange，提问作者Pragyan