docai.cc

Claude 流式响应中途断开:怎么排查

流式常见流式stream

30 秒结论

流式连接被中间层掐断了。多数是网关的空闲超时。

报错原文对照

stream error: unexpected EOF

event: error / overloaded_error

原因排序

概率 原因
45% 反向代理空闲超时(常见 60s)
30% 客户端没处理 keepalive
25% 上游真的断了

修法

先在自己这边查

  1. 把网关的 read timeout 调到 300s 以上
  2. 客户端开 keepalive
  3. 先关掉流式,用非流式验证是不是同一个问题

再往服务方查

  1. 中转站要检查自己的 nginx / 网关配置

责任判定表

现象 责任方
非流式正常 流式链路
所有模型都断 网关
只有长回答断 超时设置

什么时候该换

如果你自己搭中转,先把 proxy_buffering 关掉试试。

还是没解决?把报错贴进来

纯本地判断,不上传你的报错内容。支持 400 / 401 / 403 / 404 / 413 / 429 / 500 / 502 / 503 / 504 / 529 及常见错误码文字。

新用户福利:先免费试,再决定充值

注册就送积分,可兑换 API 额度。拿真实请求验证本页结论,比看十篇教程都有用。

领免费额度