HGfast Cloud 灵狐加速 · 一站式全球云网络返回首页

Cloudflare 502 Bad Gateway 错误怎么解决?按故障层级排查

更新于 2026-11-16 · hgfastapp.lol

简答:Cloudflare 502 最常见原因是源站返回了 502、服务进程停止、反向代理连不上后端,或 Tunnel 配置的地址、协议、端口不匹配。先看错误页是否带 Cloudflare 品牌,再用 curl 对比代理和源站响应。

定义:Cloudflare 502 Bad Gateway 表示请求链路中的网关无法从源站或后端服务获得可用响应,但故障不一定发生在 Cloudflare 本身。

先做这一步:看页面样式并对比代理、源站

本文依据 Cloudflare 官方文档整理,页面核对日期为 2026-11-16。Cloudflare 官方将 502/504 分为两类:源站返回的错误,以及 Cloudflare 侧产生的错误;其中源站返回的 502/504 更常见。先不要清缓存、改 DNS 或反复重启,先保存完整 URL、发生时间、时区、页面底部的 Ray ID,以及错误页是否带 Cloudflare 品牌。参考 Error 502 or 504 · Cloudflare Support docs。

快速判断:带 Cloudflare 品牌的 502,通常表示源站返回了标准 502;没有品牌、近似空白页的 502,才进一步检查 Cloudflare 到源站的链路、压缩响应、Gateway 或其他边缘问题。页面外观只能缩小范围,仍需用响应头和源站直连复核。

将下面的占位符替换为实际域名、源站地址和端口。Windows 请使用 curl.exe;Linux/macOS 使用 curl。

Windows:curl.exe -svo NUL https://www.example.com/
Linux/macOS:curl -svo /dev/null https://www.example.com/

这一步重点记录 HTTP 状态码、server、cf-ray、cf-cache-status 等响应头。Cloudflare 官方建议使用 curl 检查 HTTP 错误,并通过直连源站比较代理响应。

Linux/macOS:curl -svo /dev/null http://example.com/ --connect-to ::203.0.113.34
Windows:curl.exe -svo NUL http://example.com/ --connect-to ::203.0.113.34

其中 203.0.113.34 只是示例地址,必须替换为实际源站 IP;如果有多个源站,应逐台测试。该方法来自 Gathering information for troubleshooting sites · Cloudflare Support docs。

按现象决定先查哪里

不同表现对应的优先级不同。下面的决策顺序适合站长或运维人员,也能帮助普通访客判断应把信息交给谁。

  • 立即返回 502:优先查源站 Web 服务、反向代理 upstream、应用进程和监听端口。重点看是否出现 connection refused、upstream prematurely closed connection、连接后端失败或进程崩溃。
  • 等待几十秒后返回 502 或转为 504:优先查源站负载、应用耗时、数据库调用、连接池、反向代理超时和防火墙策略。Cloudflare 文档指出,源站过载、崩溃、网络故障、超时或被阻断的服务都可能造成这类问题。
  • 仅部分地区、部分节点或部分时间失败:先记录失败时间、URL、Ray ID 和 /cdn-cgi/trace 输出,再对比不同网络、IPv4/IPv6、不同源站和不同 Cloudflare 节点。若没有 CF-RAY,请求可能没有到达 Cloudflare 网络,需继续排查本地运营商、路由或 Cloudflare IP 可达性。
  • 只有 Tunnel 发布的应用失败:先查 cloudflared 是否能访问 ingress 中配置的本地服务;Tunnel 显示 Healthy 只代表连接器与 Cloudflare 网络的连接状态,不代表内部应用一定可访问。

需要查看全局状态时,可参考站内的 Cloudflare Status 怎么查;若页面实际显示的是 520、521、522 或 524,应转到对应错误码排查,不要把所有 5xx 都按 502 处理。

源站、Nginx、Apache 与应用进程怎么查

先确认 Web 服务是否运行,再确认它是否监听了反向代理配置中的实际地址和端口。下面命令中的服务名、端口和路径都要替换为你的实际值。

Nginx

sudo systemctl status nginx --no-pager
sudo nginx -t
sudo journalctl -u nginx -n 100 --no-pager
sudo tail -n 100 /var/log/nginx/error.log

如果日志出现 upstream connection refused,检查 upstream 地址、端口和后端进程;如果出现 upstream timed out,检查应用耗时、代理超时与服务器负载。

Apache

sudo systemctl status apache2 --no-pager
sudo journalctl -u apache2 -n 100 --no-pager
sudo tail -n 100 /var/log/apache2/error.log

部分系统服务名为 httpd,日志路径也可能是 /var/log/httpd/error_log,以当前系统配置为准。重点检查反向代理目标、模块加载和后端连接失败。

PHP-FPM

sudo systemctl status php-fpm --no-pager
sudo journalctl -u php-fpm -n 100 --no-pager
sudo ss -tlnp | grep <PHP-FPM端口>

如果发行版使用版本化服务名,例如 php8.2-fpm,请替换服务名。检查 Nginx 或 Apache 配置中的 socket、TCP 地址、权限以及 PHP-FPM 是否达到进程或连接上限。

Node.js

sudo systemctl status <node服务名> --no-pager
sudo journalctl -u <node服务名> -n 100 --no-pager
curl -v http://127.0.0.1:<应用端口>/

如果 Node.js 由 PM2、Docker 或其他进程管理器启动,需在对应管理器中查看状态和日志;不要只看 Nginx,因为 Nginx 正常运行不代表 Node.js 后端正常。

Docker

docker ps
docker ps -a
docker logs --tail 100 <容器名或容器ID>
docker inspect <容器名或容器ID>

检查容器是否退出、端口映射是否正确、容器内应用监听的是 0.0.0.0 还是仅监听 127.0.0.1,以及反向代理连接的是宿主机端口还是容器网络名称。端口测试只能说明 TCP 或 HTTP 访问情况,不能单凭 ping 判断 Web 后端是否可用。

HTTPS 回源、端口、防火墙与压缩响应

若源站直连正常、代理请求失败,继续检查 Cloudflare 的 SSL/TLS 模式、回源端口、源站证书和防火墙白名单。先确认源站实际提供的是 HTTP 还是 HTTPS,再核对代理配置是否连接到相同协议和端口;不要为了绕过错误长期关闭证书验证。

  • 源站端口不匹配:确认 Web 服务监听端口、Cloudflare 支持的回源端口、反向代理 upstream 端口三者一致。
  • 防火墙拦截:检查主机防火墙、云安全组、WAF 或上游防火墙是否允许来自 Cloudflare 的访问,并查看拒绝日志。
  • 证书或 SNI 不匹配:直连 IP 时保留正确 Host,并用实际域名测试证书;若证书覆盖的主机名不同,HTTPS 回源可能失败。
  • 压缩响应异常:无品牌 502 可能与源站 gzip 响应错误有关,例如压缩内容与 content-length 不一致。可在维护窗口临时关闭源站压缩进行对比,确认后修复压缩配置,而不是长期关闭压缩。
  • HTTP/2 部分兼容:如果使用 Gateway,官方文档记录了源站仅部分支持 HTTP/2、要求降级到 HTTP/1.1 时返回 502 的场景。可按官方建议暂时在源站禁用 HTTP/2 做验证,确认后再决定长期配置。

如果实际报错是证书握手失败,可继续阅读站内的 Cloudflare 525 SSL handshake failed 排查步骤;如果是无效证书,则参考 Cloudflare 526 Invalid SSL Certificate 解决方法。

涉及 Gateway 的 HTTP/2 兼容场景,可查看 Gateway · Cloudflare One docs;涉及通用 5xx 责任边界和现场信息,可查看 Cloudflare 5xx errors · Cloudflare Support docs。

Cloudflare Tunnel 出现 502 怎么处理

Tunnel 的 502 通常不是“Tunnel 没连上 Cloudflare”,而是 cloudflared 无法访问 ingress 规则中定义的内部服务。官方文档将常见原因归纳为服务未运行、协议错误、端口错误和源站证书无法验证。

先查看 Tunnel 状态和本机日志:

cloudflared tunnel list
sudo systemctl status cloudflared --no-pager
sudo journalctl -u cloudflared -n 100 --no-pager

然后从运行 cloudflared 的同一台机器测试本地服务:

curl -v http://127.0.0.1:<实际端口>/
ss -tlnp | grep <实际端口>

重点核对以下关系:

  • ingress 中的 service 是 http:// 还是 https://,必须与本地服务实际协议一致。
  • 配置端口必须与应用监听端口一致,不能只确认应用进程存在。
  • HTTPS 源站证书的主机名必须与 Tunnel 连接时使用的主机名匹配;必要时配置正确的 originServerName 或可信 CA。
  • 如果日志出现 connection refused,优先启动后端服务或修正端口;如果出现 x509,优先修复证书信任链,不要把 noTLSVerify 当成长期方案。

这些判断与命令依据 Common errors · Cloudflare One docs。需要进一步了解 Tunnel 配置结构,可参考站内的 Cloudflare Tunnel 使用与 502 排查。

修复后如何验证,避免只恢复首页

修复完成后不要只打开首页一次。按以下顺序复测,并保留修复前后的结果:

  1. 从源站本机访问关键 URL,确认应用返回预期状态码和内容。
  2. 从外部访问 Cloudflare 代理域名,重新执行 curl,确认不再返回 502。
  3. 测试首页、登录页、API、静态资源和一个容易超时的业务 URL。
  4. 分别用至少两种网络复测;若问题只发生在部分地区,记录时间、网络、URL、Ray ID 和 /cdn-cgi/trace 的 colo 字段。
  5. 同时检查 IPv4 与 IPv6 的解析和连接结果;如果只有一种地址失败,分别核对对应监听、路由和防火墙。
  6. 观察 Nginx、Apache、应用、容器或 Tunnel 日志,确认没有新的 upstream、证书、超时或连接拒绝记录。

普通访客无法访问服务器时,可以先刷新一次、换一个网络、记录完整 URL、发生时间和 Ray ID,再联系站长;反复清浏览器缓存通常不能修复源站 502。

安全提醒:排查时不要公开 Cloudflare API Token、源站 IP、完整服务器日志或包含用户数据的请求内容。提交截图前应遮住域名管理凭据、Cookie、Authorization 头和内部地址。

常见问题 FAQ

下面的问题集中回答 Cloudflare 502 排查中最容易混淆的情况。

Cloudflare 502 常见现象与第一动作

现象可能原因先做什么
立即返回带 Cloudflare 品牌的 502源站或反向代理返回标准 502查 Nginx/Apache error.log、upstream 地址、应用进程和监听端口
等待几十秒后返回 502 或 504源站超时、负载高、后端服务被阻断查应用耗时、数据库调用、连接池、代理超时和防火墙日志
无品牌或近似空白的 502Cloudflare 到源站链路、压缩响应或边缘组件异常用 curl 查看响应头,直连源站比较状态码和响应内容
仅部分地区或节点失败网络路径、IPv4/IPv6、源站差异或边缘节点范围问题记录 Ray ID、时间和 colo,换网络并分别测试 IPv4/IPv6
Tunnel 应用返回 502cloudflared 无法访问 ingress 指向的本地服务查 cloudflared 日志、service URL、协议、端口和源站证书

常见问题

Cloudflare 502 是 Cloudflare 宕机吗?

不一定。官方文档区分源站返回的 502/504 与 Cloudflare 产生的 502/504,源站返回更常见。先看页面是否带 Cloudflare 品牌,再用 curl 直连源站比较。

Cloudflare 502 和 504 有什么区别?

502 通常表示网关从后端获得了无效或无法建立的响应,504 更偏向等待后端超时;实际仍需结合源站日志、响应耗时和代理链路判断,不能只凭数字定位。

为什么 Tunnel 显示 Healthy,访问仍然是 502?

Tunnel 的 Healthy 主要表示 cloudflared 与 Cloudflare 网络保持连接,不代表它能够访问内部应用。需要在运行 cloudflared 的机器上测试本地 URL、监听端口、服务协议和证书。

看到 502 后清缓存或改 DNS有用吗?

如果问题来自源站进程、upstream、端口、证书或 Tunnel,清缓存和改 DNS通常不能解决。应先保存错误信息,再比较代理请求与源站直连结果。

没有 CF-RAY 还能找 Cloudflare 支持吗?

可以,但应同时提供 UTC 时间窗口、完整 URL、错误截图、网络环境和 curl 输出。官方文档指出,连接超时且没有 CF-RAY 时,请求可能没有到达 Cloudflare 网络。

什么时候应该联系主机商而不是继续改 Cloudflare设置?

如果源站直连也返回 502、服务进程已崩溃、Nginx或Apache日志显示后端拒绝连接,或应用自身超时,应先让主机商或服务器维护人员处理源站问题。

相关阅读

参考资料

  1. Error 502 or 504 · Cloudflare Support docs
  2. Cloudflare 5xx errors · Cloudflare Support docs
  3. Gathering information for troubleshooting sites · Cloudflare Support docs
  4. Gateway · Cloudflare One docs
  5. Common errors · Cloudflare One docs