007CDN 官方使用指南

回源超时、长请求、生图和流式接口

配置 30–3000 秒超时,区分连接、响应头、读取、客户端取消和分层中转。

回源超时、长请求、生图与流式接口

超时是多段限制的最小值

请求可能依次经过客户端、边缘节点、节点间中转、代理层和源站。任何一层的总时限、响应头等待时限、读取时限或连接池策略,都可能先结束请求。面板显示的回源超时值不代表链路每一层已同步生效。

站点自定义回源超时允许值以控制台校验为准(当前支持范围为 30–3000 秒)。变更后应确认配置版本已下发到实际处理请求的 L1/L2 节点,并确认节点连接池已按新超时策略更新。新建节点也应从控制面配置读取该值,不应依赖固定的 30 秒默认值。

诊断约 30 秒失败

若 CDN 日志在约 30 秒后返回 502,而源站记录同一请求为 499 或 0 字节,可能是中间代理提前关闭了连接;仅提高面板数值不能证明实际超时已改变。保存请求时间、请求 ID、处理节点、配置版本、边缘错误和源站日志,核查:

  • 实际生效的响应头等待、读取和总请求时限;
  • L1 到 L2 或 L2 到源站的中转限制;
  • 配置版本是否到达处理请求的节点;
  • 连接池是否仍沿用旧超时;
  • 客户端、负载均衡器和源站是否主动取消请求。

流式响应注意事项

SSE、长轮询和生成式 POST 需要持续传输响应头及数据块。确认代理不会缓冲响应、空闲超时足够、心跳间隔短于链路空闲限制,客户端不会提前取消。普通短请求和流式请求应分别验收。

可复现测试

使用不会产生副作用的测试端点,记录请求开始、首字节、每个数据块和结束时间。逐步测试 30 秒、目标值及更长时长,确认日志状态、源站状态和实际收到的数据一致。不要用真实扣费或生产生图任务反复压测。

本文由 007CDN 文档中心维护。产品支持范围和价格以控制台及订单为准。提交工单