最常见的三个原因
首先,根本没设超时。Requests 文档写明,不设置数值时请求不会超时,代理或目标一卡住,代码可能等上几分钟甚至更久。
第二,代理本身连不上:主机或端口写错、端口没开、本机出站端口被拦、代理服务停了。这是连接阶段的失败,但我们实测抛出来的是 ProxyError。
第三,代理能通,但目标站慢,或者你设的 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 步:先量
对真实目标通过代理发 20 次左右请求,每次打印 r.elapsed.total_seconds()。elapsed 是从发出请求到响应头解析完的时间。
预期结果 你得到一个正常范围和最慢的正常响应,比如 8 秒。
第 2 步:read 设在最慢的正常响应之上
read 取明显高于它的值,比如约两倍(最慢 8 秒就取 16 到 20 秒),既不让慢但正常的页面失败,也不让死连接一直等。这是经验做法,不是 Requests 的官方建议。
第 3 步:给代理设 connect
connect 决定代理连不上时等多久才抛 ProxyError。先取你的网络能接受的值,比如 10 秒,想让故障更早暴露就调低。
第 4 步:只重试可以安全重试的
文档说明 ConnectTimeout 可以安全重试。POST 遇到 read 超时时,要先确认重复提交不会把操作做两遍。重试和退避的写法见 ProxyError 重试指南。
fetch()
仅为示例,请把占位符换成你自己的代理串。在本地对一个已关闭的端口运行,打印的是 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
- Proxy302 产品事实与价目表
产品观察 · 确认日期:
2026 年 11 月 10 日对照控制台、后端和价目表核对的产品事实:租期、价格(US$,1 PTC = US$1)、协议和端口、无免费试用。
- Requests 文档:Advanced Usage,Timeouts 一节
官方文档 · 确认日期:
2026 年 11 月 17 日读到:默认不设超时;connect 超时是建立连接的等待时间,建议取略大于 3 的倍数;read 超时是等服务器两次发来数据之间的时间;传一个数同时用于两者,传 (connect, read) 元组则分开设;connect 超时对每个尝试的 IP 地址单独计算;两者都不是总时长上限。另读了 Proxies 和 SOCKS 两节:socks5h 让代理解析域名,需要安装 requests[socks]。
- Requests 文档:API 参考,异常部分
官方文档 · 确认日期:
2026 年 11 月 17 日读到:Timeout 同时捕获 ConnectTimeout 和 ReadTimeout;ConnectTimeout 可以安全重试。
- Proxy302 本地实测(requests 2.32.5,urllib3 2.6.3)
本地示例 · 确认日期:
2026 年 11 月 17 日用 requests 连三种本地目标,timeout=(2, 3):能连上但从不回应的服务器、已关闭的本地端口、不可路由地址。代理连不上或被拒绝时抛 ProxyError(不可路由地址在 2 秒后抛出,原因是 ConnectTimeoutError);代理接受连接但一直沉默时,不管访问 http 还是 https 站点,都在 read 秒数后抛 ReadTimeout。其他版本的表现可能不同。