HTTP 502 或 504 错误表示 Cloudflare 无法与你的源站 Web 服务器建立联系。
可能有两种原因:
在日志或分析数据中,你也可能看到 504 状态码。这可能是由 Early Hints 缓存未命中响应引起的,也可能是由 Cloudflare Workers Cache API 的 cache.match 操作发生缓存未命中 ↗引起的。
要解决 502/504 错误,必须确定问题源于你的源站 Web 服务器还是 Cloudflare。在以下各节中,你可以找到排查并解决来自这两种来源的错误的更多详情。
当你的源站 Web 服务器以标准 HTTP 502 bad gateway 或 504 gateway timeout 错误响应时,Cloudflare 会返回带有 Cloudflare 品牌的 HTTP 502 或 504 错误:
请联系你的托管服务提供商,排查源站 Web 服务器上的这些常见原因:
- 确保源站服务器对访客 URL 中生成
502或504错误的主机名与域名的请求做出响应。 - 调查服务器负载过高、崩溃或网络故障。
- 识别超时或被阻止的应用或服务。
源自 Cloudflare 的 502 或 504 错误显示如下:空白页面,没有 Cloudflare 品牌:
如果错误页面带有 Cloudflare 品牌标识,502 或 504 错误来自源站服务器。请参阅来自源站的 502/504 错误,并联系你的托管服务提供商。
未带品牌标识的 502 或 504 错误可能由源站的压缩问题引起,例如源站提供经 gzip 编码的压缩内容,却未更新 content-length 标头,或者提供了损坏的 gzip 压缩内容。要诊断此问题,可以尝试在源站禁用压缩,确认错误是否消失。
此外,在某些情况下,特定数据中心可能突然遇到流量激增。为尽量减少对客户的影响,我们的自动化流程会将流量重定向到另一个数据中心。这些调整通常无缝进行,仅需几秒钟。但是,在此过程中,部分客户端可能经历暂时延迟或 HTTP 502 错误。有关我们自动化流量管理工具的更多信息,请参阅此 blogpost ↗。
若你需要我们支持团队的进一步协助,请向 Cloudflare Support 提供以下详情,以避免处理你的咨询时出现延误:
- 问题发生的时间戳以及时区。
- 导致 HTTP
502或504响应的 URL(例如https://www.example.com/images/icons/image1.png)。 - 浏览到
<YOUR_DOMAIN>/cdn-cgi/trace的输出。
-
如果源站仅部分支持 HTTP/2,使用 Gateway 可能会导致 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 中看到
RequestSource为earlyHintsCache的 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 的容量与部署位置。