For the complete documentation index, see llms.txt. This page is also available as Markdown.

超时 Timeout

Timeout / Connection timed out

表示:

请求在规定时间内未完成

这是开发者接入代理时最常见的问题之一。


一、常见报错示例

cURL

curl: (28) Connection timed out

Python requests

requests.exceptions.Timeout

Node.js

ETIMEDOUT

二、常见原因


1️⃣ 网络环境问题

部分国内网络环境:

建议优先使用:

  • 海外 VPS

  • 海外云服务器


2️⃣ 请求超时时间过短

默认超时时间可能不足。


cURL 示例


Python 示例


3️⃣ 代理节点不稳定

可能出现:

  • 节点切换

  • 网络波动

  • 临时拥堵

建议增加:


4️⃣ DNS 解析异常

可能导致:

建议:

  • 更换 DNS

  • 使用海外服务器


三、推荐排查方式

建议先使用 curl 测试:

重点检查:

  • 是否能建立连接

  • IP 是否正常返回

  • 是否卡在 DNS 或 CONNECT 阶段


四、如何降低 Timeout?

推荐:

  • 使用海外网络环境

  • 增加超时时间

  • 增加 Retry 重试

  • 避免超高并发请求


五、推荐开发者调试流程


六、相关文章

最后更新于

这有帮助吗?