Python requests请求中的异常总结
一. 连接超时
服务器在指定时间内没有应答,抛出异常 requests.exceptions.ConnectTimeout
requests.get('http://github.com', timeout=0.001) # 抛出异常 requests.exceptions.ConnectTimeout: HTTPConnectionPool(host='github.com', port=80): Max retries exceeded with url: / (Caused by ConnectTimeoutError(<urllib3.connection.HTTPConnection object at 0x7f1b16da75f8>, 'Connection to github.com timed out. (connect timeout=0.001)'))
二. 连接、读取超时
若分别指定连接和读取的超时时间,服务器在指定时间没有应答,抛出异常 requests.exceptions.ConnectTimeout- timeout=([连接超时时间], [读取超时时间])
- 连接:客户端成功连接服务器的时间
- 读取:服务器收到请求并成功处理请求的时间
requests.get('http://github.com', timeout=(6.05, 0.01)) # 抛出异常 requests.exceptions.ReadTimeout: HTTPConnectionPool(host='github.com', port=80): Read timed out. (read timeout=0.01)
三. 未知的服务器
请求未知的服务器,抛出异常requests.exceptions.ConnectionError
requests.get('http://github.comasf', timeout=(6.05, 27.05)) # 抛出异常 requests.exceptions.ConnectionError: HTTPConnectionPool(host='github.comasf', port=80): Max retries exceeded with url: / (Caused by NewConnectionError('<urllib3.connection.HTTPConnection object at 0x7f75826665f8>: Failed to establish a new connection: [Errno -2] Name or service not known',))
四. 代理连接不上
代理服务器拒绝与HTTP客户端建立连接;或者请求服务器端口拒绝连接或未开放,抛出异常requests.exceptions.ProxyError
requests.get('http://github.com', timeout=(6.05, 27.05), proxies={"http": "192.168.10.1:800"}) # 抛出异常 requests.exceptions.ProxyError: HTTPConnectionPool(host='192.168.10.1', port=800): Max retries exceeded with url: http://github.com/ (Caused by ProxyError('Cannot connect to proxy.', NewConnectionError('<urllib3.connection.HTTPConnection object at 0x7fce3438c6d8>: Failed to establish a new connection: [Errno 111] Connection refused',)))
五. 连接代理超时
连接代理服务器没有响应,抛出异常requests.exceptions.ConnectTimeout
requests.get('http://github.com', timeout=(6.05, 27.05), proxies={"http": "10.200.123.123:800"}) # 抛出错误 requests.exceptions.ConnectTimeout: HTTPConnectionPool(host='10.200.123.123', port=800): Max retries exceeded with url: http://github.com/ (Caused by ConnectTimeoutError(<urllib3.connection.HTTPConnection object at 0x7fa8896cc6d8>, 'Connection to 10.200.123.123 timed out. (connect timeout=6.05)'))
六. 代理读取超时
说明HTTP与代理服务器成功建立连接,代理服务器也成功发送请求到目标服务器,但是代理服务器读取目标服务器资源超时;即使代理服务器访问或者读取目标服务器的资源速度很快,但是如果代理服务器访问的目标服务器器返回资源过慢导致超时,这个锅还是代理服务器背;
例如:假定代理可用,timeout参数代表向代理服务器的连接和读取过程的超时时间(不用关心代理服务器是否与目标服务器连接和读取成功)。
requests.get('http://github.com', timeout=(2, 0.01), proxies={"http": "192.168.10.1:800"}) # 抛出错误 requests.exceptions.ReadTimeout: HTTPConnectionPool(host='192.168.10.1:800', port=1080): Read timed out. (read timeout=0.5)
七. 网络环境异常
可能是断网导致,抛出异常 requests.exceptions.ConnectionError
requests.get('http://github.com', timeout=(6.05, 27.05)) # 抛出异常 requests.exceptions.ConnectionError: HTTPConnectionPool(host='github.com', port=80): Max retries exceeded with url: / (Caused by NewConnectionError('<urllib3.connection.HTTPConnection object at 0x7fc8c17675f8>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution',))
【注意】所有的Requests显式抛出的异常都继承至 requests.exceptions.RequestException 类。
八. 官网的一些参考
你可以告诉 requests 在经过以 timeout 参数设定的秒数时间之后停止等待响应。基本上所有的生产代码都应该使用这一参数。如果不使用,你的程序可能会永远失去响应: >>> requests.get('http://github.com', timeout=0.001) Traceback (most recent call last): File "<stdin>", line 1, in <module> requests.exceptions.Timeout: HTTPConnectionPool(host='github.com', port=80): Request timed out. (timeout=0.001) 并不是整个下载响应的时间限制,而是如果服务器在 timeout 秒内没有应答,将会引发一个异常(更精确地说,是在 timeout 秒内没有从基础套接字上接收到任何字节的数据时) - 遇到网络问题(如:DNS 查询失败、拒绝连接等)时,Requests 会抛出一个 requests.exceptions.ConnectionError 异常。 - 如果 HTTP 请求返回了不成功的状态码, Response.raise_for_status() 会抛出一个 HTTPError 异常。 - 若请求超时,则抛出一个 Timeout 异常。 - 若请求超过了设定的最大重定向次数,则会抛出一个 TooManyRedirects 异常。 - 所有Requests显式抛出的异常都继承自 requests.exceptions.RequestException 。
去期待陌生,去拥抱惊喜。