Cloudflare 503 Service Unavailable 怎么解决?先判断源站还是 Cloudflare
简答:先看 503 错误页 HTML:没有 cloudflare 或 cloudflare-nginx,优先查源站过载、限流、维护和连接池;包含这些字段,再收集时间、URL、Ray ID 与 cdn-cgi/trace,检查 Cloudflare 与 Workers。
定义:Cloudflare 503 Service Unavailable 表示当前服务器或处理链路暂时无法处理请求,常见责任方包括源站、Cloudflare 数据中心或 Workers。
先用 1 分钟判断:503 是谁返回的?
本文按 2026-11-16 核对的页面为准。Cloudflare(自称、未核实)的官方支持资料把 503 分为源站生成、Cloudflare 生成,以及只出现在日志或分析中的情况。最先检查错误页正文,而不是先改 DNS、SSL 或客户端设置。
- 错误页 HTML 没有
cloudflare或cloudflare-nginx:优先判断为源站直接返回,检查主机限流、过载、维护模式、CPU、内存和连接池。 - 错误页 HTML 包含
cloudflare或cloudflare-nginx:按 Cloudflare 生成的 503 方向收集域名、发生时间、时区和/cdn-cgi/trace输出。 - 只在日志或分析中出现:官方页面说明这可能是 Speed Brain 预取失败,访客未必能看到;不要把这类记录直接等同于用户访问失败。
来源:Error 503。
先做这组检查:状态码、错误页和 trace
以下命令中的 https://example.com/、域名和路径都是占位符,请替换为实际地址。命令只读取 HTTP 响应,不代表能够证明源站内部一定正常。
curl -iL --max-time 20 https://example.com/重点记录 HTTP 状态码、响应头、错误页正文和是否出现 Retry-After。如果正文是完整业务站点页面,搜索结果可能受自定义错误页影响;只对当前 503 错误页正文判断,不要因为页面脚本、统计代码或资源地址包含 cloudflare 就下结论。
curl -sS --max-time 20 https://example.com/cdn-cgi/trace这条命令用于收集 Cloudflare 诊断输出。若你是普通访问者,保存错误截图、完整 URL、发生时间和时区后联系网站管理员;Cloudflare 的 5xx 总览也建议站点访客向网站所有者报告问题,而不是自行修改站点配置。来源:Cloudflare 5xx errors。
源站返回 503:按 Nginx、Apache、PHP-FPM、Node.js 和 Docker 排查
如果错误页不含 cloudflare 或 cloudflare-nginx,优先从源站开始。先确认是否正在发布、维护或重启,再检查资源和服务日志。以下是常见做法,服务名和日志路径需按实际部署替换。
- Nginx:检查状态和错误日志。
sudo systemctl status nginx sudo journalctl -u nginx --since "30 minutes ago" sudo tail -n 200 /var/log/nginx/error.log - Apache:检查服务状态和发行版对应的错误日志。
sudo systemctl status apache2 sudo journalctl -u apache2 --since "30 minutes ago" sudo tail -n 200 /var/log/apache2/error.log如果服务名为
httpd,将命令中的apache2替换为httpd。 - PHP-FPM:确认 PHP-FPM 没有停止、子进程耗尽或请求堆积。
sudo systemctl status php-fpm sudo journalctl -u php-fpm --since "30 minutes ago"部分系统使用版本化服务名,例如
php8.2-fpm,请替换为实际服务名。 - Node.js:如果由 systemd 管理,查看应用服务和最近日志。
sudo systemctl status your-node-service sudo journalctl -u your-node-service --since "30 minutes ago" - Docker:确认容器仍在运行,并查看应用容器日志。
docker ps docker logs --since 30m <container_name_or_id>
修复方向包括降低突发并发、检查 CPU 和内存是否饱和、确认数据库或上游连接池没有耗尽、结束错误的维护模式,并核对主机商是否对源站请求限流。不要只提高超时时间;若应用本身无法处理请求,超时设置可能掩盖根因。
HTTP 503 通常用于临时不可用状态;MDN 还指出,内存、CPU 或连接池达到阈值时,应用可能返回 503,若预计恢复时间明确,可使用 Retry-After。来源:503 Service Unavailable - HTTP | MDN。
Cloudflare 生成 503:检查事件、HTTP Traffic 和 Ray ID
如果错误页包含 cloudflare 或 cloudflare-nginx,先不要把问题归因于 Nginx 或 PHP。保留发生时间、时区、完整 URL、响应截图、Ray ID,以及同一时间的 /cdn-cgi/trace 输出。
- 进入 Cloudflare 控制台的 HTTP Traffic,选择添加筛选条件,按 Edge status code 或 Origin status code 查看 5xx。控制台名称可能随版本调整,以当前页面为准。
- 如果账户具备相应日志功能,可在 Observability > Logs 中按 Ray ID 查询相关请求;没有该功能时,使用已保存的 URL、时间和响应信息交给站点管理员或主机商。
- 检查 Security > Events 是否存在主动缓解事件。不要把安全事件、源站过载和 Cloudflare 数据中心连接问题混为同一类。
Cloudflare 文档说明,Error Analytics 可按错误码、URL、来源 IP 和数据中心观察错误,但其数据基于流量样本;日志入口和筛选项应以当前控制台为准。来源:Cloudflare 5xx errors。
若还无法判断,可参考站内的Cloudflare Status 与故障排查指南,先确认是否存在公开维护或区域性异常。
Workers 返回 503:看资源限制和错误日志
使用 Workers 时,503 可能与 Worker 超出 CPU 时间限制或代码触发内存限制有关。官方 503 页面建议在 Workers 控制台查看错误日志和资源限制问题;资料没有提供统一的固定日志关键词,因此不要把自拟字段名当作真实日志原文。
- 确认 503 是否只发生在经过 Worker 的路径,还是源站直出路径也失败。
- 在 Workers 对应项目的日志或观测页面检查发生时间、请求路径和异常记录。
- 回看最近发布的代码,重点检查大对象处理、循环、同步计算、批量请求和未释放的响应内容。
- 修复后重新访问同一路径,并用
curl -i检查状态码;不要仅凭一次浏览器刷新判断已经恢复。
Cloudflare 资料明确列出 Workers CPU 时间限制和内存限制两类 503 成因,但具体限制取决于产品和计划,页面未核实的版本、数值与字段名不在本文展开。
503 与其他错误码怎么区分?
先看实际状态码和错误页,不要用 503 的处理方法套用到所有 Cloudflare 5xx。下表只给出排查方向;更细的错误码定义应进入对应官方页面核对。
- 429:偏向请求限流;MDN 将其定义为 Too Many Requests,不能按源站过载的 503 流程直接处理。
- 500:内部服务器错误,优先查应用异常和源站日志。
- 502 或 504:网关错误或网关超时,优先查代理与上游响应链路。
- 520:源站返回未知错误;需要保存完整响应和时间信息。
- 521:源站不可达或服务器未提供服务,检查源站进程、防火墙和监听状态。
- 522:连接超时,重点看 Cloudflare 到源站的连接建立过程。
- 524:连接建立后等待源站响应超时,重点看应用处理时间和上游依赖。
如果你实际看到的是 521、522 或 524,可继续查看站内的Cloudflare 521 排查、Cloudflare 522 排查和Cloudflare 524 排查,避免混用诊断路径。
修复后如何验证,避免错误页继续影响访问?
修复完成后,至少从同一 URL 做三类验证:
- HTTP 验证:执行
curl -iL --max-time 20 https://example.com/path,确认返回码、响应正文和关键响应头已经恢复。 - 应用验证:检查 Nginx、Apache、PHP-FPM、Node.js 或 Docker 日志,确认没有持续出现相同时间段的资源耗尽、服务重启或上游失败。
- Cloudflare 验证:在 HTTP Traffic 中按 Edge status code 或 Origin status code 观察同一路径;若保留了 Ray ID,也可按 Ray ID 查询日志。
如果只有某些地区或某些网络仍然失败,先对比不同网络的状态码、完整 URL、发生时间和 trace 输出,再判断是区域链路、Cloudflare 数据中心、源站策略还是缓存差异。不要仅凭 ping 判断网站是否恢复,也不要在没有证据时反复切换 DNS、SSL 或 MTU。
若导入或连接后的访问仍表现为部分地区异常,可将不同网络的状态码、时间和 trace 输出整理后,再使用面向网络连接诊断的服务进行对比;它不能替代源站修复。
Cloudflare 503 的现象、可能原因与先做什么
| 现象 | 可能原因 | 先做什么 |
|---|---|---|
| 错误页没有 cloudflare 或 cloudflare-nginx | 源站过载、限流、维护模式、CPU/内存或连接池问题 | 检查源站服务状态、应用日志、主机商限流与资源使用情况 |
| 错误页包含 cloudflare 或 cloudflare-nginx | Cloudflare 数据中心连接问题或 Cloudflare 侧生成错误 | 保存域名、完整 URL、发生时间、时区、Ray ID,并执行 /cdn-cgi/trace |
| 只在日志或分析中出现 503,访客页面正常 | Speed Brain 预取失败等仅日志场景 | 先确认访客是否真的看到 503,再决定是否检查或调整相关功能 |
| 只经过 Workers 的路径失败 | Worker CPU 时间或内存限制、代码异常 | 查看 Workers 错误日志、资源限制和最近发布变更 |
| 修复后仍返回 503 | 缓存、上游服务未恢复、不同节点或地区仍有差异 | 用 curl 检查同一 URL,并对比 HTTP Traffic、源站日志和不同网络结果 |
常见问题
普通访问者遇到 Cloudflare 503,应该刷新还是联系网站管理员?
可以先等待片刻并刷新一次,随后用其他网络访问同一 URL。如果仍然返回 503,保存完整地址、截图、发生时间和时区,联系网站管理员;访客通常无法修复源站或 Cloudflare 配置。
错误页里出现 cloudflare,就一定是 Cloudflare 故障吗?
不应只看浏览器页面标题。应检查当前 503 错误页 HTML 是否包含 cloudflare 或 cloudflare-nginx,并同时记录 Ray ID、时间、URL 和 cdn-cgi/trace。自定义错误页可能改变默认外观,因此最终仍要结合日志判断。
Cloudflare 503 和 429 有什么区别?
503 表示服务暂时无法处理请求,常见方向是维护、过载或资源阈值;429 表示请求受到限流。若错误明确为 429,应优先检查访问频率、限流规则和客户端重试行为,而不是先扩大源站资源。
为什么 Workers 没有明显报错,页面却返回 503?
Worker 可能在执行过程中触发 CPU 时间或内存限制。检查对应 Worker 的错误日志、资源使用和最近发布内容,重点排查大对象、循环、同步计算和批量请求。具体限制数值需以当前产品与计划页面为准。
修复源站后,Cloudflare 503 还会持续多久?
无法仅凭状态码确定持续时间。应使用 curl 检查实际响应、查看源站日志是否停止报错,再在 Cloudflare HTTP Traffic 中按 Edge status code 或 Origin status code 对比;如果只有部分地区失败,还要记录不同网络的结果。