跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

错误 499

最后更新 查看 MarkdownAgent 设置

499 客户端关闭请求

如果客户端在请求完成前关闭连接,Cloudflare 会在日志和分析中记录 499 状态码。不会向客户端发送 499 HTTP 响应;此代码只会显示在日志中。

客户端可能因常见原因断开连接,例如页面导航、应用取消请求或请求超时。任何 zone 上出现较低的 499 比率都属正常,并不表示存在故障。如果该比率明显高于 zone 的正常基线、持续集中在某个 Cloudflare 数据中心,或影响对延迟敏感的端点,请进一步调查。

需要调查的常见模式

单独一个 499 无法确定原因或故障位置。较短的客户端截止时间与请求路径中任意位置的延迟升高相结合——例如源站连接、源站响应、缓存填充、边缘处理或响应正文传输——都可能导致 499 比率升高。要诊断路径中哪一部分造成了影响,需要结合比较多个日志字段和匹配的请求集合。

导致 499 比率升高的常见模式包括:

模式 需要关注的信号 起点
客户端截止时间短于路径延迟 特定端点上的比率升高。对这些端点上匹配的已完成请求进行检查时,会发现 OriginResponseDurationMs 升高或边缘处理时间延长。 比较同一端点和时间范围内匹配的已完成请求,并检查源站侧的计时数据。
缓存未命中导致延迟升高 受影响路径的缓存命中率下降,499 比率随命中率变化而变化。 检查受影响路径的缓存配置。
可能存在边缘或网络问题 相较于其他匹配组,一个数据中心的比率明显偏高,但无法从客户端计时、源站证据或缓存行为中找到原因 收集与请求关联的证据并比较匹配组。如果仍无法解释,请联系 Cloudflare 支持

调查方法

使用 Instant Logs 或导出 Logpush 数据,收集受影响端点、客户端群体、协议和时间范围内的请求。保留 499 日志条目以及其他符合条件的请求。仅按 EdgeResponseStatus = 499 筛选的导出数据无法提供对照请求,也无法提供计算 499 比率所需的分母。

将 EdgeResponseStatus = 499 的请求数除以同一群体中的所有符合条件请求数,计算 499 比率。如果日志经过采样,请在两项计数中一致地考虑采样。对于 Instant Logs,估算请求数时请使用返回的 sampleInterval 值。另行使用匹配的已完成请求比较计时字段。

没有任何单个字段可以确定原因。请结合匹配的请求群体和与请求关联的证据来分析以下字段:

  • OriginIP — 记录的请求源站 IP。缺少此值并不能确定请求在哪个环节停止。缓存提供服务的请求可能无需获取源站内容。已中止或日志记录不完整的请求也可能没有源站 IP。请结合 CacheCacheStatus 和与请求关联的证据分析此字段。
  • CacheCacheStatus — 记录 HTTP requests 数据集中的缓存处理结果。hit 或 stale 等值表示响应由缓存提供,因此没有源站 IP 可能是预期行为。dynamic 表示请求不符合缓存条件,也可能包括被防火墙拦截的请求。miss 或 bypass 等值有助于确定要调查的请求,但不能证明曾尝试连接源站,也不能确定已中止的请求停在哪个环节。在判断原因前,请收集与请求关联的证据和源站侧证据。
  • EdgeColoCode — 如果某个数据中心的 499 错误增加,请在同一时间范围内,比较各数据中心针对相同端点、客户端群体和协议的符合条件流量中的 499 比率。某个位置的比率显著高于其他匹配组,可作为有用线索,但仅凭位置无法确定是否存在基础设施故障。
  • UTC 时间范围和流量趋势 — 比较不同时间范围内相同端点、客户端群体和协议的 499 比率。使用每个匹配群体中所有符合条件的请求作为分母。流量构成差异可能导致 499 比率不同,但无法据此确定故障。

调查 499 激增:

  1. 确定受影响的端点和时间范围。使用相同端点、客户端群体和协议的所有符合条件请求计算 499 比率。将该比率与同一群体的正常基线比较。在下一步中,另用匹配的已完成请求比较计时数据。
  2. 比较匹配的已完成请求中的 OriginResponseDurationMs 与相同端点、客户端群体和协议的正常基线。此字段测量请求到达的第一个 Cloudflare 数据中心所观察到的上游响应时间,其中包括 Argo Smart Routing 和 Tiered Cache 的耗时,以及连接源站并接收响应的时间。该值偏高无法确定延迟发生在哪个环节。请结合源站侧计时和与请求关联的证据进行分析。不要仅凭 499 条目中的计时值推断失败阶段或将延迟归因于源站服务器。
  3. 检查受影响请求的 OriginIP 和 CacheCacheStatus。在同一时间范围内,使用匹配的端点、客户端和协议群体比较各数据中心的 499 比率。miss 或 bypass 对应的源站 IP 缺失,是需要结合请求关联证据和源站侧证据调查的线索。如果比率升高仍无法解释,请联系 Cloudflare 支持,并提供受影响的时间范围、示例 Ray ID 和匹配组比较结果。

TCP 连接计时

连接限制参考中列出了源站连接阶段 19 秒的 TCP 连接建立时限。如果客户端在建立源站连接期间断开,将产生 499 日志条目。

这是可能发生 499 的一个阶段。客户端也可能在 HTTP 请求阶段、发送响应标头时或传送响应正文时断开。要确定客户端断开时所处的阶段,应比较 EdgeTimeToFirstByteMs、EdgeResponseBodyBytes 和匹配的已完成请求,而不是仅凭 499 条目推断。

长时间运行和流式响应

如果客户端在响应完成前断开,499 可能在发送第一个字节前发生,也可能在响应正文开始传送后发生。例如,超时时限较短的客户端可能在建立源站连接或等待响应期间断开;超时时限较长的客户端可能在接收大型响应正文的过程中断开。

对于流式响应(HLS、DASH 或其他媒体格式)和其他长时间运行的请求,客户端使用的连接和读取超时默认值各不相同;有些可在应用层配置,有些则不可配置。

调查长时间运行或流式响应中的 499 错误:

  1. 确认当前生效的超时设置:查看客户端或 SDK 文档;如有可能,请向开发团队确认该超时是否可配置。
  2. 检查 499 日志条目中的 EdgeTimeToFirstByteMs 和 EdgeResponseBodyBytes,并与相同路径的匹配已完成请求进行比较。响应正文字节数大于零,说明正文传送可能已经开始。正文为零或缺失,本身并不能证明断开发生在第一个字节发送之前。如果阶段仍不明确,请使用客户端计时或与请求关联的证据。
  3. 如果受影响路径可缓存且缓存命中率下降,请检查缓存配置。命中率较低会增加源站获取次数,并可能增加首字节传送和正文传送的延迟。
  4. 使用匹配的路径、客户端群体和协议比较各数据中心的 499 比率,并以每个群体中所有符合条件的请求作为分母。如果某个数据中心的比率显著升高,且源站或缓存无法解释,请联系 Cloudflare 支持。

事务敏感型请求

对于旨在修改服务器状态的请求,记录到 499 并不能单独确定操作结果。客户端可能在断开前已收到响应标头或部分响应正文。如果应用尚未确认结果,请在重试前核实该操作。

处理结果未确认的请求:

  • 将受影响的请求和操作 ID 与应用的事务记录或操作状态端点匹配。如果结果仍处于待处理或未知状态,请遵循应用的核对和重试策略。
  • 如果应用支持幂等键,请将其用于会更改状态的端点。重试同一操作时应重复使用相同的键,并遵循应用文档规定的键作用范围、保留期限和重试行为。

何时联系 Cloudflare 支持

出现以下情况时,请联系支持:

  • 相同端点和时间范围内的 499 错误明显高于 zone 的正常基线,且源站响应时间或缓存命中率没有相应变化可以解释这一激增。
  • 受影响请求没有记录 OriginIP,且 CacheCacheStatus 为 miss 或 bypass;在检查匹配的请求群体、客户端计时和源站侧证据后,499 比率升高仍无法解释。请将这些字段值作为调查线索,而不是 Cloudflare 故障的证明。
  • 同一时间范围内,一个数据中心的 499 比率显著高于同一 zone 的其他数据中心所服务的匹配流量,且源站或缓存无法解释这一差异。

联系支持时,请提供:

  • 受影响的主机名和 zone ID
  • UTC 时间范围(开始和结束时间)
  • 499 日志条目中的 10–20 个 Ray ID
  • 这些日志条目的 OriginIP 和 CacheCacheStatus 值
  • 499 条目的 EdgeColoCode 分布,以及同一时间范围内其他数据中心匹配组的 499 比率
  • 其他 zone 或主机名是否在同一时间出现相同激增
  • 对于 Enterprise 客户:包含该时间范围内受影响 499 条目及匹配对照请求的 Logpush 导出数据

这篇文档对您有帮助吗?