0

0

PythonHTTP重试机制教程_请求可靠性保障

冷炫風刃

冷炫風刃

发布时间:2026-01-08 12:52:02

|

542人浏览过

|

来源于php中文网

原创

HTTP请求重试需合理控制时机、次数、条件和退避策略:优先用requests+urllib3内置Retry(支持状态码、异常类型、指数退避、方法限制);复杂场景手动实现(捕获异常、业务判断、随机抖动);异步推荐aiohttp+tenacity;须重视幂等性、分层超时、监控告警与降级兜底。

pythonhttp重试机制教程_请求可靠性保障

HTTP请求失败很常见,网络波动、服务端临时不可用、限流等都可能导致请求中断。Python中实现可靠的重试机制,关键不是“多试几次”,而是合理控制重试时机、次数、条件和退避策略。

用requests + urllib3内置重试最轻量

requests底层基于urllib3,其Retry类已封装完整重试逻辑,无需额外依赖。适合大多数同步请求场景。

  • 指定要重试的HTTP状态码(如502、503、504、429)和连接异常类型(如ConnectTimeout、MaxRetryError)
  • 设置backoff_factor启用指数退避:第n次重试前等待backoff_factor × (2^(n-1))秒(例如factor=1时,等待1→2→4→8秒)
  • 限制最大重试次数(total)和针对特定方法的重试(如禁用POST重试避免重复提交)

示例:

from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
import requests
<p>session = requests.Session()
retry_strategy = Retry(
total=3,
status_forcelist=[429, 502, 503, 504],
method_whitelist=["HEAD", "GET", "OPTIONS"],
backoff_factor=1
)
adapter = HTTPAdapter(max_retries=retry_strategy)
session.mount("http://", adapter)
session.mount("https://", adapter)</p><p>response = session.get("<a href="https://www.php.cn/link/85c19375f0c12c6793bf66b4e2666dc4">https://www.php.cn/link/85c19375f0c12c6793bf66b4e2666dc4</a>")  # 自动重试最多3次
</p>

自定义重试逻辑:捕获异常+手动控制

当需要更精细判断(如根据响应内容决定是否重试)、或集成日志、监控、熔断时,建议手动实现重试循环。

立即学习Python免费学习笔记(深入)”;

  • try/except捕获requests.exceptions.RequestException及其子类(ConnectionError、Timeout、HTTPError等)
  • response.status_code做业务级判断:比如401可刷新token后重试,400则直接放弃
  • 使用time.sleep()配合随机抖动(jitter),避免重试请求扎堆冲击服务端

示例(带抖动的简单重试):

Dora
Dora

创建令人惊叹的3D动画网站,无需编写一行代码。

下载
import time
import random
import requests
<p>def fetch_with_retry(url, max_retries=3):
for i in range(max_retries + 1):
try:
resp = requests.get(url, timeout=5)
resp.raise_for_status()  # 抛出4xx/5xx异常
return resp
except requests.exceptions.RequestException as e:
if i == max_retries:
raise e</p><h1>指数退避 + 最多0.5秒随机抖动</h1><pre class="brush:php;toolbar:false;">        sleep_time = min(2 ** i + random.uniform(0, 0.5), 10)
        time.sleep(sleep_time)
return None

异步场景:aiohttp + tenacity组合更稳妥

在asyncio项目中,不能直接用time.sleep或requests。推荐aiohttp搭配重试库tenacity——它原生支持async/await,配置灵活。

  • tenacity提供@retry装饰器,可按异常类型、返回值、耗时等条件触发重试
  • 支持wait_exponential()(指数退避)、wait_random()(随机间隔)、stop_after_attempt()等策略组合
  • 避免在协程中阻塞,所有等待通过await asyncio.sleep()完成

示例:

import asyncio
import aiohttp
from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type
<p>@retry(
stop=stop_after_attempt(3),
wait=wait_exponential(multiplier=1, min=1, max=10),
retry=retry_if_exception_type((aiohttp.ClientError, asyncio.TimeoutError))
)
async def fetch_async(session, url):
async with session.get(url, timeout=5) as response:
if response.status >= 400:
raise aiohttp.ClientResponseError(
response.request_info, response.history, status=response.status
)
return await response.text()</p><p>async def main():
async with aiohttp.ClientSession() as session:
result = await fetch_async(session, "<a href="https://www.php.cn/link/4d2fe2e8601f7a8018594d98f28706f2">https://www.php.cn/link/4d2fe2e8601f7a8018594d98f28706f2</a>")
print(result)
</p>

别忽略重试的副作用与边界

重试不是万能解药,滥用反而加剧问题。必须结合业务语义审慎设计:

  • 幂等性优先:GET、HEAD、OPTIONS天然幂等;POST/PUT/DELETE需确认服务端是否支持幂等(如携带Idempotency-Key头)
  • 超时要分层:连接超时(connect timeout)通常设1~3秒,读取超时(read timeout)视业务定(如API调用5~30秒),总耗时=重试次数×(连接+读取)
  • 监控与告警:记录重试次数、最终失败原因(是网络问题?还是500频发?),便于定位真实瓶颈
  • 降级兜底:重试全部失败后,应返回缓存数据、默认值或明确错误提示,而非让上游持续等待

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6607

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

842

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

1092

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

2112

2024.03.01

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

443

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

605

2023.08.10

数据库Delete用法
数据库Delete用法

数据库Delete用法:1、删除单条记录;2、删除多条记录;3、删除所有记录;4、删除特定条件的记录。更多关于数据库Delete的内容,大家可以访问下面的文章。

287

2023.11.13

drop和delete的区别
drop和delete的区别

drop和delete的区别:1、功能与用途;2、操作对象;3、可逆性;4、空间释放;5、执行速度与效率;6、与其他命令的交互;7、影响的持久性;8、语法和执行;9、触发器与约束;10、事务处理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

222

2023.12.29

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号