火山引擎流式输出中断是因传输层或网关提前终止会话，未发出finish事件；需检查超时设置、配额状态、模型冷却及SSE格式合规性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎流式输出到一半就断开，说明增量事件链路在 finish 事件发出前被强制终止，客户端收不到完整响应，常见于超时、配额耗尽、网络抖动或服务端策略拦截。这种情况不是偶发丢包，而是整个流式会话提前终结。
确认是否收到 finish 事件
打开浏览器开发者工具→Network 标签页→找到对应请求→点击查看响应内容→逐行滚动查找 type:"finish" 的 JSON 块。没有该块，说明服务端根本没发出终止信号，问题出在传输层或中间网关截断。
若看到 type:"finish" 但 content 字段为空或 reason 字段为 "error" 或 "abort"，说明模型生成中途被策略引擎拦截（如敏感词触发、长度突变），需查火山引擎控制台「安全中心→内容审核日志」。
检查流式请求头与超时设置
方法一：curl 测试时必须显式加 --max-time 300，否则默认 60 秒超时会直接断开连接，服务端来不及发 finish 事件。
方法二：在 API 请求头中设置 Timeout: 300（单位秒），同时确保火山引擎网关未覆盖该值——部分企业版网关会强制将流式请求超时设为 120 秒，需联系技术支持调整。
【Timeout 必须和服务端 max_tokens 预估耗时匹配】 例如请求含 3000 tokens 输入 + 设 max_tokens=8192，按平均 15 tokens/秒生成速度，至少需预留 750 秒，此时设 Timeout: 300 就必然中断。
验证配额与模型冷却状态
第一步：访问火山引擎「用量中心」→切换至「CodingPlan」服务页→查看「当前周期剩余 Token 数」和「TPM（Tokens Per Minute）实时使用率」。
第二步：执行 openclaw logs --follow →搜索 "429" 或 "quota" 关键词。若出现 "AccountQuotaExceeded" 或 "model_cooldown"，说明账户已触发硬性限流，服务端会在下一个 delta 事件前主动关闭连接，不发 finish。
第三步：登录火山方舟控制台→进入「Coding Plan 管理」→确认所选模型右侧显示「可用」状态。若显示「冷却中」或「额度不足」，立即切换至 ark-code-latest 或升级 Pro 套餐。
捕获原始流式数据块做断点分析
用 curl -N -X POST 'https://api.volcengine.com/xxx' -H 'Content-Type: application/json' -d '{"stream":true}' > stream.log，等待输出中断后立即 Ctrl+C 停止。
用 vim stream.log 打开文件，从末尾往前翻：如果最后几行是连续的 {"type":"delta","content":"..."}，但突然断在半截 JSON（如 content 字段引号未闭合、逗号缺失），说明是网络层断流或服务端进程崩溃；如果最后是 {"type":"finish",...} 完整对象，则客户端解析逻辑有 bug，未正确监听 data: 前缀。
注意：SSE 协议要求每条消息以 data: 开头并以 \n\n 结尾，若服务端返回纯 JSON 而非 data: {...}\n\n 格式，前端 EventSource 会直接报错终止，不会等 finish。
