异常状态码参考
EdgeOne 响应的异常状态码分为以下几类:
标准状态码
请求回源后,由源站响应的状态码信息,节点将透传源站响应的状态码返回给客户端。
由 EdgeOne 节点直接响应,例如:Token 鉴权不通过,响应 403 状态码。可能由 EdgeOne 节点直接响应的状态码包含以下状态码:
状态码 | 含义说明 |
400 | |
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 |
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 | |
567 |