curl -N https://api.example.com/chat | tail -c 200

流式接口读完后前端 loading 一直转,后端日志显示最后一个 chunk 之后连接没有关闭。先别急着动参数,把报错原文和时间点记下来,顺序反了容易白折腾。

原因不复杂,循环按 chunk 是否有内容判断结束,没识别 DONE 标记,读取一直阻塞到超时。前端等不到结束事件。

围绕「流式结束标识」排查时,命令行跑一遍比在面板里点十次有用,面板会替你做掉不少隐式操作。备份不是备了就行,恢复一次才算数,很多备份文件打开才发现是空的。

接口问题先分清是没发出去、发出去了没收到,还是收到了处理失败。偶发问题先统计频率,一小时几次和一天一次,查法完全不同。

改完顺手把文档补一句,省得下次自己重新推一遍。

处理上按这个顺序:解析时遇到 DONE 主动 break 并关闭连接;给前端发一个自定义结束事件;加读取超时兜底 30 秒;用真实流式响应回归。

改完只确认一件事:最后一个事件后连接立即关闭 前端 loading 在 1 秒内停止。

作者 9823189