异常状态码参考

原创

EdgeOne小助手

发布于 2024-08-27 16:48:49

1320

发布于 2024-08-27 16:48:49

EdgeOne 响应的异常状态码分为以下几类：

您可以参考 HTTP 状态码标准 来查看具体的状态码含义，这类状态码通常在以下情况下响应：

状态码	含义说明
400	客户端请求不合法，如请求 Method 不在 EdgeOne 的允许范围内。
403	未通过防盗链校验，如规则引擎的 Token 鉴权。
416	range 范围异常，如 rangeStart < 0、rangeStart > rangeEnd、rangeStart > FileSize。
418	对于接入 EdgeOne 的域名，系统会自动为域名分配服务节点，且对应的节点均会下发该域名的配置文件，其中文件内容取决于域名的配置，如源站、缓存、头部等。当请求发送给节点时，节点会读取域名的配置文件，当发现配置文件不存在时，则响应 418 状态码。例如，客户端请求：http://example.com/test.jpg，则节点会读取域名 example.com的配置文件，可能由于绑定了非 example.com 域名的服务节点，CNAME 配置错误或者调度系统异常等原因，客户端会接收到 418 响应。
423	触发请求回环，有以下 2 个场景：CDN-Loop 头部的 Loops 数值 ≥ 16，详情请参见 CDN-Loop。同一个请求，两次经过同一台节点设备。

由 EdgeOne 自定义的特殊含义的状态码，包含499、520-599 之间的状态码均为 EdgeOne 保留的自定义非标准状态码响应，建议您在业务中避免使用该范围内状态码，避免与 EdgeOne 的状态码产生混淆。

如下为 EdgeOne 自定义的异常状态码以及含义说明，方便您在业务访问异常时进行自助排障。

状态码	含义说明
499	客户端请求到节点，还没等到节点响应就主动断开请求，如关闭请求页面等，则日志&监控会记录为 499 状态码。
520	节点与源站建连成功后，向源站发起请求，但源站直接发送 RST 包，则节点响应客户端 520 状态码。
521	节点请求到源站，在 TCP 建连阶段，源站直接发送 RST 包，则节点响应客户端 521 状态码。
522	节点请求到源站，在 TCP 建连阶段，源站一直没有响应导致节点超时，则节点响应客户端 522 状态码。
523	若域名配置的源站为域名，则节点回源时，需要解析域名获取源站服务器 IP，若解析失败，则节点无法回源，响应客户端 523 状态码。
524	节点与源站建连成功后，向源站发起请求，源站一直没有响应导致节点超时，则节点响应客户端 524 状态码。
525	若回源协议为 HTTPS，则节点回源时需要与源站进行 SSL 握手，若握手失败，则节点响应客户端 525 状态码。
566	当请求被 Web 防护-托管规则拦截时，默认使用 566 状态码和默认拦截页面响应请求。若用户配置了自定义拦截状态码，则会使用用户配置的状态码。
567	当请求被 Web 防护-自定义规则、Web 防护-速率限制或 Bot 管理规则拦截时，默认使用 567 状态码和默认拦截页面响应请求。若用户配置了自定义拦截状态码，则会使用用户配置的状态码。