Python requests.post()超时设置

最新推荐文章于 2025-03-06 15:56:26 发布

谷满满

最新推荐文章于 2025-03-06 15:56:26 发布

阅读量1.9w

点赞数 3

分类专栏： python 文章标签： python

本文链接：https://blog.csdn.net/antch620/article/details/123566888

版权

python 专栏收录该内容

46 篇文章

订阅专栏

本文介绍了Python中使用requests.post()进行网络请求时如何设置超时参数。默认情况下，requests.post()会阻塞直到完成，可通过指定timeout参数来控制连接（connect）和读取（read）超时。例如，timeout=2.50表示连接和读取共用的超时时间，而timeout=(3, 1)则分别设置了连接和读取的超时时间。了解这两个超时类型对于优化网络请求的性能和避免程序挂起至关重要。" 95626163,8669448,Windows环境下Apache Tomcat 7.0.54安装教程,"['Java', '操作系统', '数据库', 'Web服务器']

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

requests.post()，默认是阻塞的，除非显式指定了 timeout 值，否则不会做超时处理。

参数值

参数描述
url 必须。请求的网址
data 可选。字典，元组列表，字节或要发送到指定URL的文件对象
json 可选。要发送到指定URL的JSON对象
files 可选。要发送到指定URL的文件字典
allow_redirects 可选。用于启用/禁用重定向的布尔值。
默认True（允许重定向）
auth 可选。用于启用某种HTTP身份验证的元组。
默认None
cert 可选。指定证书文件或密钥的字符串或元组。
默认None
cookies 可选。要发送到指定网址的Cookie字典。
默认None
headers 可选。要发送到指定网址的HTTP标头字典。
默认None
proxies 可选。URL代理协议字典。
默认None
stream 可选。如果响应应立即下载（False）或流式传输（True）的布尔指示。
默认False
timeout 可选。一个数字或一个元组，指示等待客户端建立连接和/或发送响应的秒数。
默认值None表示请求将继续，直到连接关闭
verify 可选。用于验证服务器TLS证书的布尔值或字符串指示。
默认True

参数		描述
url		必须。请求的网址
data		可选。字典，元组列表，字节或要发送到指定URL的文件对象
json		可选。要发送到指定URL的JSON对象
files		可选。要发送到指定URL的文件字典
allow_redirects		可选。用于启用/禁用重定向的布尔值。默认`True`（允许重定向）
auth		可选。用于启用某种HTTP身份验证的元组。默认`None`
cert		可选。指定证书文件或密钥的字符串或元组。默认`None`
cookies		可选。要发送到指定网址的Cookie字典。默认`None`
headers		可选。要发送到指定网址的HTTP标头字典。默认`None`
proxies		可选。URL代理协议字典。默认`None`
stream		可选。如果响应应立即下载（False）或流式传输（True）的布尔指示。默认`False`
timeout		可选。一个数字或一个元组，指示等待客户端建立连接和/或发送响应的秒数。默认值`None`表示请求将继续，直到连接关闭
verify		可选。用于验证服务器TLS证书的布尔值或字符串指示。默认`True`

超时设定举例

1、值设为数字

requests.post(url, data = myobj, timeout=2.50)

解析：配置的 timeout=2.50 ，这个值是作为 connect 和 read 二者共用的 timeout

2、值设为元组

requests.post(url, data = myobj, timeout=(3, 1))

解析：元组 timeout=(3, 1) ，第一个值为 connect连接超时时间，第二个值为 read 读取超时时间

名词解析

1、connect 连接超时
指的是客户端request连接远端服务器端口的等待的时间。
连接超时一般设为比 3 的倍数略大的一个数值，因为 TCP 数据包重传窗口的默认大小是 3。

2、read 读取超时
指的客户端已经连接上服务器并且发送了 request 后，客户端等待服务器返回请求的时间。
一般指的是服务器发送第一个字节之前的时间。