跳转到内容
搜索文档

错误 502 或 504

最后更新 查看 MarkdownAgent 设置

错误 502 bad gateway 或错误 504 gateway timeout

HTTP 502504 错误表示 Cloudflare 无法与你的源站 Web 服务器建立联系。

常见原因

可能有两种原因:

你也可能在日志或分析中看到由 Early Hints 的 cache MISS 响应 引起的 504 状态代码,或由 Cloudflare Workers Cache API cache.match 操作导致 cache MISS 引起的 504 状态代码。

解决方案

要解决 502/504 错误,必须确定问题源于你的源站 Web 服务器还是 Cloudflare。在以下各节中,你可以找到排查并解决来自这两种来源的错误的更多详情。

来自你的源站 Web 服务器的 502/504

当你的源站 Web 服务器以标准 HTTP 502 bad gateway504 gateway timeout 错误响应时,Cloudflare 会返回带有 Cloudflare 品牌的 HTTP 502504 错误:

Cloudflare 品牌错误 502 示例。

请联系你的托管服务提供商,排查源站 Web 服务器上的这些常见原因:

  • 确保源站服务器对访客 URL 中生成 502504 错误的主机名与域名的请求做出响应。
  • 调查服务器负载过高、崩溃或网络故障。
  • 识别超时或被阻止的应用或服务。

来自 Cloudflare 的 502/504

源自 Cloudflare 的 502504 错误显示如下:空白页面,没有 Cloudflare 品牌:

无品牌错误 502 示例。

若错误未提及 cloudflare,请联系你的托管服务提供商寻求协助。更多信息请参阅 来自你的源站的 502/504 错误

此错误可能由源站的压缩问题引起,例如源站服务器提供 gzip 编码的压缩内容但未更新 content-length 请求头,或源站提供损坏的 gzip 压缩内容。要诊断此问题,你可以尝试在源站禁用压缩以确认是否能解决错误。

此外,在某些情况下,特定数据中心可能突然遇到流量激增。为尽量减少对客户的影响,我们的自动化流程会将流量重定向到另一个数据中心。这些调整通常无缝进行,仅需几秒钟。但是,在此过程中,部分客户端可能经历暂时延迟或 HTTP 502 错误。有关我们自动化流量管理工具的更多信息,请参阅此 blogpost

若你需要我们支持团队的进一步协助,请向 Cloudflare Support 提供以下详情,以避免处理你的咨询时出现延误:

  • 问题发生的时间戳以及时区。
  • 导致 HTTP 502504 响应的 URL(例如 https://www.example.com/images/icons/image1.png)。
  • 浏览到 <YOUR_DOMAIN>/cdn-cgi/trace 的输出。

导致 HTTP 错误 502 或 504 的已知 Cloudflare 问题

  • 使用 Gateway 时,若源站仅部分支持 HTTP/2,可能导致 HTTP 错误 502。更多详情与解决方案请参阅故障排除

  • 通过 Cloudflare Tunnel 连接到 HTTP 或 HTTPS 应用时,你可能会看到 502 Bad Gateway 错误,并附带 Unable to reach the origin service. The service may be down or it may not be responding to traffic from cloudflared。这意味着 tunnel 本身已连接到 Cloudflare 网络,但 cloudflared 无法到达你在 ingress 规则中定义的源站服务。更多详情与解决方案请参阅 tunnel 常见错误页面

  • 启用 Early Hints 时,你可能在 Cloudflare Logs 中看到 RequestSourceearlyHintsCache 的 HTTP 错误 504 激增,这是预期且无害的。更多详情与解决方案请参阅 Early Hints 文章

  • 若你使用 Dedicated CDN Egress IPs 连接到源站,当 Cloudflare 在向源站打开新连接时暂时耗尽 Dedicated CDN Egress IPs 的可用源端口时,也可能发生 502 错误。每个 Dedicated CDN Egress IP 可为每个源站 IP 端口支持最多 40,000 个并发连接,因此对单个源站的高并发连接量可能耗尽可用端口并导致间歇性 502 错误,即使源站健康也是如此。Dedicated CDN Egress IPs 受益于连接复用与合并,这会降低打开到源站的连接数,并减少达到此限制的可能性。若你怀疑端口耗尽,请联系你的客户团队,审查 Dedicated CDN Egress IPs 的容量与部署位置。

这篇文档对您有帮助吗?