Claude 流式响应中途断开：怎么排查
流式输出到一半断开的原因：网关超时、心跳缺失、客户端缓冲。，附超时设置与断线重连处理。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
流式stream
30 秒结论
流式连接被中间层掐断了。多数是网关的空闲超时。
报错原文对照
stream error: unexpected EOF
event: error / overloaded_error原因排序
| 概率 | 原因 |
|---|---|
| 45% | 反向代理空闲超时（常见 60s） |
| 30% | 客户端没处理 keepalive |
| 25% | 上游真的断了 |
修法
先在自己这边查
- 把网关的 read timeout 调到 300s 以上
- 客户端开 keepalive
- 先关掉流式，用非流式验证是不是同一个问题
再往服务方查
- 中转站要检查自己的 nginx / 网关配置
责任判定表
| 现象 | 责任方 |
|---|---|
| 非流式正常 | 流式链路 |
| 所有模型都断 | 网关 |
| 只有长回答断 | 超时设置 |
什么时候该换
如果你自己搭中转，先把 proxy_buffering 关掉试试。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证