EdgeOne 4XX/5XX 状态码排障指南

Recent Pages

EdgeOne 4XX/5XX 状态码排障指南

最后更新时间：2024-12-16 12:02:52

在接入 EdegOne 后，如果您的业务请求出现 4XX/5XX 状态码，您可以参照如下的常见原因和解决思路进行排查。
说明：
若您参照以下排障指南仍然无法解决问题，您可以 联系我们 进行排查。为了方便定位，请您提供 EO-LOG-UUID 信息。若没有，请提供以下详细信息：
用户 IP、EdgeOne 节点 IP；
特定的 4XX、5XX 错误代码和消息；
发生 4XX、5XX 错误的时间和时区；
导致 HTTP 4XX、5XX 错误的 URL（例如https://www.example.com/images/icons/image1.png：）。
HTTP 400
1. 含义：服务器因某些被认为是客户端错误的原因（例如，请求语法错误、无效请求消息格式或者欺骗性请求路由），而无法或不会处理该请求。
2. 可能的原因及解决思路：
源站响应：直接访问源站测试，若源站响应 400，则修改源站配置或修改客户端请求行为以获取正确响应。
EdgeOne 节点响应：
请检查请求方法是否在 EdgeOne 支持的范围内，非以下请求方法，EdgeOne 节点将直接响应 400 状态码。
GET、HEAD、POST、PUT、DELETE、TRACE、CONNECT、OPTIONS、PATCH、COPY、LOCK、MKCOL、MOVE、PROPFIND、PROPPATCH、UNLOCK。
协议格式错误，如使用 443 端口访问 HTTP。
HTTP 请求不符合 RFC 规范。
HTTP 403
1. 含义：服务器因某些被认为是客户端错误的原因（例如，请求语法错误、无效请求消息格式或者欺骗性请求路由），而无法或不会处理该请求。
2. 可能的原因及解决思路：
源站响应：直接访问源站测试，若源站响应 403，则修改源站配置或修改客户端请求行为以获取正确响应。
EdgeOne 节点响应：常见的原因是未通过防盗链校验。
请检查是否在规则引擎配置了 HTTP 应答，若有，看是否命中了如 Referer 黑白名单、IP 黑白名单、User-Agent 黑白名单等基础访问控制。
请检查是否在规则引擎配置了 Token 鉴权，若有，核对客户端请求的 URL 是否时间戳过期或 MD5 加密串计算错误。
请检查是否通过边缘函数配置了 远程鉴权，若有，核对客户端请求的 URL 是否不符合鉴权服务器的校验放行规则。
HTTP 416
1. 含义：服务器无法处理所请求的数据区间。最常见的情况是所请求的数据区间不在文件范围之内，
2. 可能的原因及解决思路：
源站响应：直接访问源站测试，若源站响应 416，则修改源站配置或修改客户端请求行为以获取正确响应。
EdgeOne 节点响应：
异常的 range 范围，如：rangeStart < 0、rangeStart > rangeEnd、rangeStart > FileSize。
客户端请求的 range 头部不标准。如请求 Range: Bytes=0-1023，而非 Range: bytes=0-1023。
HTTP 418
1. 含义：一般服务器使用这个响应来处理它们不想处理的请求。
2. 可能的原因及解决思路：
源站响应：直接访问源站测试，若源站响应 418，则修改源站配置或修改客户端请求行为以获取正确响应。
EdgeOne 节点响应：对于接入 EdgeOne 的域名，系统会自动为域名分配服务节点，且对应的节点均会下发该域名的配置文件，其中文件内容取决于域名的配置，如源站、缓存、头部等。当请求到 EdgeOne 节点时，节点会读取域名的配置文件，当发现配置文件不存在时，则响应 418 状态码。
例如：客户端请求已接入 EdgeOne 的域名http://example.com/test.jpg，该域名的请求配置在节点 1.1.1.1、1.1.1.2 上均有相关配置，则当域名请求到这两个节点时节点会读取域名 example.com的配置文件，成功响应，如果请求到节点 2.2.2.2 上时，则会响应 418 状态码。请检查域名是否绑定了非 example.com 域名的服务节点，CNAME 配置是否正确，若检查无问题，请 联系我们 处理。
HTTP 423
1. 含义：表示 "Locked"（已锁定），在接入 EdgeOne 的场景下，一般表示触发请求回环。
2. 可能的原因及解决思路：
源站响应：直接访问源站测试，若源站响应 423，则修改源站配置或修改客户端请求行为以获取正确响应。
EdgeOne 节点响应：触发请求回环，即 CDN-Loop 头部的 Loops 数值 ≥ 16，详情请参见 CDN-Loop。一般常见于接入 EO 的加速域名，源站也设置为已接入 EO 或 CDN 加速的域名。
HTTP 520
1. 含义：EdgeOne 自定义的状态码。节点与源站 TCP 建连成功后，向源站发起 HTTP 请求，但源站直接发送 RST 包，则节点响应客户端 520 状态码。
﻿
2. 可能的原因及解决思路：
源站服务异常：直接访问源站测试并抓包，查看源站针对 HTTP 请求是否响应 RST 包，可能是源站防火墙或自身服务异常导致。
HTTP 521
1. 含义：EdgeOne 自定义的状态码。节点请求到源站，在 TCP 建连阶段，源站直接发送 RST 包，则节点响应客户端 521 状态码。
﻿
2. 可能的原因及解决思路：
源站服务异常：直接访问源站测试，可使用 curl 或 telnet 等命令工具，查看 TCP 连接是否能建连，通常是源站的某些端口未对公网开放或源站节点网络问题。
HTTP 522
1. 含义：EdgeOne 自定义的状态码。节点请求到源站，在 TCP 建连阶段，源站一直没有响应导致节点超时，则节点响应客户端 522 状态码。
﻿
2. 可能的原因及解决思路：
源站服务异常：直接访问源站测试，可使用 curl 或 telnet 等命令工具，查看 TCP 连接是否能建连，通常是源站的某些端口未对公网开放或源站节点网络问题。
HTTP 523
1. 含义：EdgeOne 自定义的状态码。若域名配置的源站为域名，则节点回源时，需要解析域名获取源站服务器 IP，若解析失败，则节点无法回源，响应客户端 523 状态码。
2. 可能的原因及解决思路：
尝试 dig 解析源站域名，确认是否能正常解析。
若源站域名能正常解析，请 联系我们 处理。
HTTP 524
1. 含义：EdgeOne 自定义的状态码。节点与源站建连成功后，向源站发起请求，源站一直没有响应导致节点超时，则节点响应客户端 524 状态码。
﻿
2. 可能的原因及解决思路：
源站服务异常：直接访问源站测试，查看针对 HTTP 请求是否有响应，若源站正常响应，可以尝试调整回源超时时间。如果仍然有问题，请联系我们处理。
HTTP 525
1. 含义：EdgeOne 自定义的状态码。若回源协议为 HTTPS，则节点回源时需要与源站进行 SSL 握手，若握手失败，则节点响应客户端 525 状态码。
﻿
2. 可能的原因及解决思路：
请检查是否域名回源协议配置为 HTTPS，但源站没有部署证书。若是，可在域名管理处将回源协议修改为 HTTP，或者在源站部署对应域名的证书。
节点和源站 SSL 握手时由于网络原因出现丢包。
回源证书合法性校验不通过，目前 EdgeOne 默认会校验证书有效期。