常见错误

创建连接超时

• 异常名称：ConnectionTimeoutError
• 出现场景：通常是 DNS 查询比较慢，或者客户端与服务端之间的网络速度比较慢导致的。
• 排查建议：请适当增大 timeout 参数。

服务响应超时

• 异常名称：ResponseTimeoutError
• 出现场景：通常是客户端与服务端之间网络速度比较慢，并且响应数据比较大的情况下会发生。
• 排查建议：请适当增大 timeout 参数。

服务主动断开连接

• 异常名称：ResponseError, code: ECONNRESET
• 出现场景：通常是服务端主动断开 socket 连接，导致 HTTP 请求链路异常。
• 排查建议：请检查当时服务端是否发生网络异常。

服务不可达

• 异常名称：RequestError, code: ECONNREFUSED, status: -1
• 出现场景：通常是因为请求的 url 所属 IP 或者端口无法连接成功。
• 排查建议：请确保 IP 或者端口设置正确。

域名不存在

• 异常名称：RequestError, code: ENOTFOUND, status: -1
• 出现场景：通常是因为请求的 url 所在的域名无法通过 DNS 解析成功。
• 排查建议：请确保域名存在，也需要排查一下 DNS 服务是否配置正确。

JSON 响应数据格式错误

• 异常名称：JSONResponseFormatError
• 出现场景：设置了 dataType=json 并且响应数据不符合 JSON 格式，就会抛出此异常。
• 排查建议：确保服务端无论在什么情况下都要正确返回 JSON 格式的数据。