跳到正文

requests 代理超时:connect 和 read

哪一个超时触发了、异常名说明了什么,以及怎样用自己测出的响应时间来定数值。

最常见的三个原因

首先,根本没设超时。Requests 文档写明,不设置数值时请求不会超时,代理或目标一卡住,代码可能等上几分钟甚至更久。

第二,代理本身连不上:主机或端口写错、端口没开、本机出站端口被拦、代理服务停了。这是连接阶段的失败,但我们实测抛出来的是 ProxyError。

第三,代理能通,但目标站慢,或者你设的 read 比最慢的正常响应还小,这时是 ReadTimeout。按这个顺序往下查。

哪个异常对应什么情况

哪个异常对应什么情况
项目发生了什么requests 2.32.5 抛出的异常
代理主机或端口写错、端口没开立刻被拒绝连接ProxyError
代理地址没有回应大约在 connect 秒数后失败ProxyError,原因是 ConnectTimeoutError
代理接受连接后一直沉默在 read 秒数后失败ReadTimeout
代理正常,但目标站很慢在 read 秒数后失败ReadTimeout

来源:Proxy302 本地实测,2026 年 11 月 17 日,requests 2.32.5 搭配 urllib3 2.6.3,timeout=(2, 3);其他版本可能不同。ProxyError 是 ConnectionError 的子类,Timeout 同时捕获 ConnectTimeout 和 ReadTimeout。

connect 和 read 分别量什么

connect 超时是 Requests 等待建立连接的时间,文档建议取略大于 3 的倍数,因为 3 秒是 TCP 默认的重传窗口。read 超时是客户端等服务器两次发来数据之间的间隔,几乎所有情况下就是等首个字节的时间。

只传一个数,如 timeout=5,两者都用它;传元组如 timeout=(3.05, 27) 则分开设。实际用起来有两点要注意:域名解析出多个地址时会逐个尝试,所以 connect 的总等待可能是你设值的几倍;两个值都不是总时长上限,数据一点点往下渗的响应可以超过两者。

按自己的数据定数值

  1. 第 1 步:先量

    对真实目标通过代理发 20 次左右请求,每次打印 r.elapsed.total_seconds()。elapsed 是从发出请求到响应头解析完的时间。

    预期结果 你得到一个正常范围和最慢的正常响应,比如 8 秒。

  2. 第 2 步:read 设在最慢的正常响应之上

    read 取明显高于它的值,比如约两倍(最慢 8 秒就取 16 到 20 秒),既不让慢但正常的页面失败,也不让死连接一直等。这是经验做法,不是 Requests 的官方建议。

  3. 第 3 步:给代理设 connect

    connect 决定代理连不上时等多久才抛 ProxyError。先取你的网络能接受的值,比如 10 秒,想让故障更早暴露就调低。

  4. 第 4 步:只重试可以安全重试的

    文档说明 ConnectTimeout 可以安全重试。POST 遇到 read 超时时,要先确认重复提交不会把操作做两遍。重试和退避的写法见 ProxyError 重试指南。

fetch()

import requests
from requests.exceptions import ConnectTimeout, ReadTimeout, ProxyError, RequestException

PROXY = "http://LOGIN:PASSWORD@HOST:PORT"
PROXIES = {"http": PROXY, "https": PROXY}

def fetch(url, connect=10, read=30):
    try:
        r = requests.get(url, proxies=PROXIES, timeout=(connect, read))
        r.raise_for_status()
        return r
    except ProxyError as e:
        print("proxy not reachable or refused:", e)
    except ConnectTimeout:
        print("connect timed out after", connect, "s")
    except ReadTimeout:
        print("connected, no data for", read, "s")
    except RequestException as e:
        print("other request error:", type(e).__name__)

if __name__ == "__main__":
    fetch("https://ipinfo.io/json")

仅为示例,请把占位符换成你自己的代理串。在本地对一个已关闭的端口运行,打印的是 ProxyError 那一支。

仍然失败时按顺序查

立刻 ProxyError,提示 Unable to connect to proxy

检查 代理串里的主机、端口和协议。在 Proxy302 上主机是 proxy.proxy302.com,HTTP 用 2222 端口,SOCKS5 用 3333 端口。

处理 到「我的资产」复制主机、端口、用户名和密码。用 SOCKS5 要安装 requests[socks],并写 socks5h://,让代理来解析域名。

停止条件 同一个代理串在 curl 里能用、Python 里不行,就接着查环境里的 HTTP_PROXY 和 HTTPS_PROXY。

正好等了 connect 秒数后 ProxyError

检查 你的网络或防火墙是否允许出站连接到这个端口。

处理 换一个网络试同一个代理。检查顺序见 ERR_PROXY_CONNECTION_FAILED 排查清单。

停止条件 几个网络都连不上同一个代理,带订单号提交工单。

只有走代理才 ReadTimeout

检查 同一个网址直连和走代理各请求一次,比较 r.elapsed。

处理 直连也慢,就给这个目标调大 read;只有走代理慢,先换一个国家或另一个网址测。

停止条件 所有网址走代理都失败、直连都正常,就别再调超时了,联系客服。

脚本一直不结束

检查 每一次调用是否都带了 timeout,包括封装函数里的调用?

处理 每处都传 timeout,或者封装 Session,保证总会补上默认值。

在 Proxy302 上怎么用

动态住宅的同一组用户名和密码,既能走 proxy.proxy302.com 的 2222 端口(HTTP),也能走 3333 端口(SOCKS5)。Session 会复用连接,而动态线路每个新连接换一个 IP,所以超时迫使它新建连接时,IP 就会变。

最小的一笔是 1 GB 动态住宅流量,没有免费试用,所以先用一小笔流量试你的超时数值。价格见动态住宅页和价格页,基础配置见 requests 代理指南。

常见问题

python requests 默认超时是多少?

没有默认超时。不设置数值时请求不会超时,一次调用可能等上几分钟甚至更久。

为什么是 ProxyError 而不是 ConnectTimeout?

代理本身连不上时,requests 2.32.5 抛的是 ProxyError,原因是 ConnectTimeoutError。除了 Timeout,也要捕获 ProxyError。

timeout=10 是指请求 10 秒后就停吗?

不是。10 分别用于 connect 和 read,而且两者都不是总时长上限,数据慢慢往下流的响应会超过 10 秒。

read 超时也包括代理吗?

实际上包括:我们实测,代理接受了连接却什么都不发,无论访问 http 还是 https 站点,都是 ReadTimeout。

能给整个 Session 设一个超时吗?

给 session.timeout 这样的属性赋值没有效果。每次调用都传 timeout,或者继承 Session、挂一个适配器来补默认值。

参考资料

4
  1. Proxy302 产品事实与价目表

    产品观察 · 确认日期:

    2026 年 11 月 10 日对照控制台、后端和价目表核对的产品事实:租期、价格(US$,1 PTC = US$1)、协议和端口、无免费试用。

  2. Requests 文档:Advanced Usage,Timeouts 一节

    官方文档 · 确认日期:

    2026 年 11 月 17 日读到:默认不设超时;connect 超时是建立连接的等待时间,建议取略大于 3 的倍数;read 超时是等服务器两次发来数据之间的时间;传一个数同时用于两者,传 (connect, read) 元组则分开设;connect 超时对每个尝试的 IP 地址单独计算;两者都不是总时长上限。另读了 Proxies 和 SOCKS 两节:socks5h 让代理解析域名,需要安装 requests[socks]。

  3. Requests 文档:API 参考,异常部分

    官方文档 · 确认日期:

    2026 年 11 月 17 日读到:Timeout 同时捕获 ConnectTimeout 和 ReadTimeout;ConnectTimeout 可以安全重试。

  4. Proxy302 本地实测(requests 2.32.5,urllib3 2.6.3)

    本地示例 · 确认日期:

    2026 年 11 月 17 日用 requests 连三种本地目标,timeout=(2, 3):能连上但从不回应的服务器、已关闭的本地端口、不可路由地址。代理连不上或被拒绝时抛 ProxyError(不可路由地址在 2 秒后抛出,原因是 ConnectTimeoutError);代理接受连接但一直沉默时,不管访问 http 还是 https 站点,都在 read 秒数后抛 ReadTimeout。其他版本的表现可能不同。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。