报错是这么冒出来的。站点挂在 Cloudflare 免费版后面,源站用 FastAPI 0.115 输出 text/event-stream,长回答到 100 秒左右浏览器必断,EventSource 抛 error 后自动重连,页面上同一段文字重复两遍。先加过 retry: 3000,又换成 Nginx 直连,源站不设代理时同一条回答能跑完 4 分钟。

中间走过弯路,把「响应头缺 Cache-Control: no-transform,中间层尝试压缩缓冲」当成主因,改完现象没变。

原因不止一个,得分开看。免费版对无数据的长连接有 100 秒空闲上限,超时直接回 524。少数情况下是源站在等模型首字时不写任何字节,代理判定连接空闲。

还有一种情况,重连后前端没带 Last-Event-ID,从头开始重新生成。

第一件事是用 curl 观察首字节时间与断开的准确时刻

curl -N -H 'Accept: text/event-stream' https://example.com/api/chat -w '\n%{time_starttransfer} %{time_total}\n'

再往下在生成循环里每 15 秒写一行注释当心跳

python -c "print(': ping', flush=True)"

补全响应头,明确禁止转换与缓冲

curl -I https://example.com/api/chat -H 'Accept: text/event-stream'

剩下的就是重连时带上最后一条事件的 id 只补增量

python -c "print('resume with Last-Event-ID')"

别只看报错消失,验证要多做一步。同一条 4 分钟的长回答一次跑完,浏览器控制台没有重连记录,页面上不再出现重复段落。

心跳用冒号开头的注释行即可,不会进入 data 分支,比发空 data 更安全,间隔要明显小于代理的空闲阈值。报错文案容易误导,真正的原因往往在相邻那一层的日志里。

作者 9823189