边缘安全加速平台 EO

异常状态码参考

最近更新时间:2024-09-09 11:37:31

我的收藏
EdgeOne 响应的异常状态码分为以下几类:

标准状态码

您可以参考 HTTP 状态码标准 来查看具体的状态码含义,这类状态码通常在以下情况下响应:
请求回源后,由源站响应的状态码信息,节点将透传源站响应的状态码返回给客户端。
由 EdgeOne 节点直接响应,例如:Token 鉴权不通过,响应 403 状态码。可能由 EdgeOne 节点直接响应的状态码包含以下状态码:
状态码
含义说明
400
客户端请求不合法,如请求 Method 不在 EdgeOne 的允许范围内。详情请参见 HTTP 限制说明
403
未通过防盗链校验,如规则引擎的 Token 鉴权。
416
range 范围异常,如 rangeStart < 0、rangeStart > rangeEnd、rangeStart > FileSize。
418
对于接入 EdgeOne 的域名,系统会自动为域名分配服务节点,且对应的节点均会下发该域名的配置文件,其中文件内容取决于域名的配置,如源站、缓存、头部等。当请求发送给节点时,节点会读取域名的配置文件,当发现配置文件不存在时,则响应 418 状态码。 例如,客户端请求:https://example.com/test.jpg,则节点会读取域名 example.com的配置文件,可能由于绑定了非 example.com 域名的服务节点,CNAME 配置错误或者调度系统异常等原因,客户端会接收到 418 响应。
423
触发请求回环,即 CDN-Loop 头部的 Loops 数值 ≥ 16,详情请参见 CDN-Loop

EdgeOne 自定义的状态码

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

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