跳转到内容
搜索文档

Cloudflare 错误诊断标头

最后更新 查看 MarkdownAgent 设置

当 Cloudflare 生成错误页面(而不是从您的源站服务器转发错误)时,响应中包含两个诊断标头:

  • cf-error-type:标识错误类别。常见值:
    • 1000 — DNS 解析失败(A 记录指向 Cloudflare IP)
    • 1016 — 源站 DNS 错误(CNAME 目标无法解析)
    • 1101 — Worker 抛出未处理的异常
    • 1102 — Worker 超出资源限制(CPU 或内存)
    • 52x — 源站连接错误(521、522、523、524、525、526)
  • cf-error-origin:标识生成错误的 Cloudflare 系统。

这些标头仅在 Cloudflare 生成的错误页面上存在,而不是在从您的源站服务器转发的错误上存在。

如何捕获这些标头

重现错误并使用以下方法之一检查响应标头:

  • curl -v https://example.com — 在响应标头中查找 cf-error-type
  • 浏览器开发者工具:选择 Network(网络) > 选择失败的请求 > Headers(标头)
  • 导出 HAR 文件并检查响应标头

使用 cf-error-type 进行诊断

cf-error-type 前缀 来源 下一步
1xxx DNS / 路由层 检查 DNS 记录;验证 A 记录中没有 Cloudflare IP
1101 / 1102 Workers 运行时 检查 wrangler tail 中的异常
52x 源站连接 检查源站服务器是否正常运行并且可访问

这篇文档对您有帮助吗?