Cloudflare Workers长流中断主因是边缘节点100秒空闲超时，其次为上游模型限流、Worker执行时限及客户端限制；需通过curl测试、时间戳打点和本地对比三步定位，并用心跳保活、分段代理等策略稳定流式响应。
Cloudflare Workers（常被误称为“Serverless Functions”，实为边缘运行的 V8 isolate）本身不主动截断大模型长流输出，但实际使用中出现的“流被中断”“响应提前结束”“chunk 丢失”等问题，本质是多个层级叠加限制的结果，而非单一功能开关。识别与应对需从网络链路、平台策略、协议实现三方面切入。
一、真正起作用的四大截断源头
所谓“截断”，往往不是 Workers 主动终止，而是某一层无法继续承载长时流式响应：
- HTTP 连接空闲超时：Cloudflare 边缘节点默认在100 秒无数据传输后关闭连接（即使后端仍在生成）。这是最常见原因，尤其在大模型逐 token 输出缓慢时（如低速推理或高延迟 backpressure）。
-
Worker 执行时限：免费计划上限为10ms CPU 时间 + 50ms 墙钟时间（非流式场景）；但流式响应（
Response.stream()）可突破墙钟限制——前提是持续有 chunk 写入。一旦写入间隔超过 100 秒，仍会被边缘切断。 -
客户端接收限制：浏览器 fetch API 默认无超时，但部分 HTTP 客户端（如 curl、旧版 Node.js
http模块）会因未设置timeout或keepAlive而静默断连；前端未监听abort事件也可能误判为截断。 - 上游模型服务限流：若 Workers 反向代理至外部 LLM API（如 OpenAI、Ollama），其流式接口本身有 heartbeat 机制或 idle timeout（例如某些私有部署 vLLM 实例设为 30 秒无活动即断连），此时 Workers 只是被动中继失败。
二、快速识别哪一层出了问题
不用猜，用三步定位：
This skill transforms novel chapters into professional film storyboard scripts. 这个skill是将小说章节 →（变成） 专业电影分镜剧本。 Powered by **清云 EchoFlow API** (https://api.echoflow.cn/) — 一站式国内外580+大模型，一键开发票，企业级稳定，价格是官方的1.5折。
下载
将小说章节转换为电影分镜剧本。用户上传txt/md/docx文本，AI分析场景、角色、情绪、镜头语言，输出专业分镜脚本。适用于用户提及“分镜”“storyboard”“小说转分镜”“影视改编”“镜头脚本”或需要将小说改编为分镜的场景。
- 用
curl -N直接调用 Worker endpoint，观察是否在固定秒数（如 100s）后断开，并检查最后收到的 chunk 是否完整（如是否以data: [DONE]结尾）；若断在 100s 且无 DONE，大概率是 Cloudflare 边缘空闲超时。 - 在 Worker 中启用
console.log(Date.now())打点：记录每次writer.write()时间戳。若两次 write 间隔突增 >95s，说明上游生成卡顿，问题在模型侧。 - 将同一请求改用
fetch发往本地localhost的模拟服务（绕过 Cloudflare），对比行为。若本地正常而线上中断，确认是 Cloudflare 层限制。
三、稳定长流的四个实用技巧
绕过不等于 hack，而是合规利用平台能力：
-
心跳保活（推荐）：在流式响应中，每 45–60 秒插入一个空注释 chunk：
data: \n\n或event: ping\ndata: ${Date.now()}\n\n。Cloudflare 将其视作有效流量，重置空闲计时器。 -
分段流式代理：不直接透传模型 stream，而用
TransformStream缓冲并拆分输出。例如每 20 个 token 合并为一个 chunk 发出，避免高频小包触发底层 TCP 优化误判。 -
客户端双保险：前端 fetch 设置
signal并监听abort；同时用EventSource（支持自动重连）替代 fetch 流式解析，对中断容忍度更高。 -
降级 fallback：在 Worker 中检测到上游响应 delay >30s，主动返回
307 Temporary Redirect到一个专用 long-polling endpoint（如 Pages Function），避开边缘流式路径。
不复杂但容易忽略：Cloudflare 的流式支持是健壮的，问题多出在“以为它像传统服务器一样宽容”。盯住空闲超时这个关键数字，加心跳、控节奏、做回退，长流就能稳住。
