讲师中心 微信公众号
AI工具推荐 视频效率加速

Python 网络请求重试的正确姿势

轻婷同学_5837

轻婷同学_5837

发布时间:2026-02-18 10:58:02

|

952人浏览过

|

来源于php中文网

原创

requests中retry不生效的主因是HTTPAdapter未通过session.mount()显式挂载到Session,且需分别挂载"http://"和"https://";status_forcelist、allowed_methods和backoff_factor配置不当也会导致重试失效。

python 网络请求重试的正确姿势

requests 里 retry 不生效?检查 Session 和 HTTPAdapter 的绑定关系

很多人直接 new 一个 requests.Session(),再配 HTTPAdapter,但没把 adapter mount 到 session 上,retry 就完全不触发。核心是:adapter 必须显式 mount 才生效,不是“设了就自动用”。

  • Session() 默认不带任何重试逻辑,哪怕你实例化了 HTTPAdapter 也不起作用
  • 必须调用 session.mount("https://", adapter) 和 session.mount("http://", adapter),否则只对匹配 scheme 的请求生效
  • 如果只 mount https://,而请求的是 http:// 地址,retry 会静默失效
  • 推荐统一 mount 两个 scheme,避免因协议切换漏掉重试

重试条件太宽或太窄?重点看 status_forcelist 和 allowed_methods

默认的 Retry 对象只对连接错误、超时重试,不会对 500、429 这类状态码重试——除非你明确写进 status_forcelist。同时,allowed_methods 控制哪些 HTTP 方法允许重试,GET/HEAD 默认开启,POST/PUT 默认关闭(因为非幂等)。

  • 要重试 502/503/504,必须加 status_forcelist=[502, 503, 504]
  • 想对 POST 也重试,得显式传 allowed_methods=["GET", "POST", "PUT", "DELETE"],但要注意语义安全
  • 429(rate limit)建议加入 status_forcelist,配合 Retry 的 backoff_factor 实现退避
  • 别盲目加 allowed_methods=["ALL"],requests 不识别这个字符串,会报 ValueError

重试间隔不按预期?backoff_factor 不是固定秒数,而是指数退避系数

backoff_factor 看起来像“每次多等几秒”,实际是按公式 wait = backoff_factor * (2 ** (retry_number - 1)) 计算等待时间,单位是秒。第一次重试不等待,第二次等 backoff_factor 秒,第三次等 backoff_factor * 2 秒,以此类推。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限

下载
  • 设 backoff_factor=1,三次重试的等待分别是:0s、1s、2s、4s
  • 设 backoff_factor=0.3,对应等待是:0s、0.3s、0.6s、1.2s——更适合高频轻量请求
  • 注意:系统时钟精度、DNS 解析耗时、网络抖动都会叠加在退避时间上,实测间隔往往比理论值略长
  • 如果需要更精细控制(比如 jitter),得自己封装 retry 逻辑,原生 urllib3.Retry 不支持

异步场景下用 aiohttp 或 httpx?别硬套 requests 的 retry 模式

requests 是同步阻塞库,它的 Retry + HTTPAdapter 在 asyncio 里完全不可用。强行用 loop.run_in_executor 包一层,不仅没解决并发问题,还掩盖了真正的异步重试需求。

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

  • aiohttp 自带 ClientTimeout,但无内置 retry;需配合 asyncio.sleep 和手动循环,或用第三方包如 aiohttp-retry
  • httpx 支持同步/异步双模式,其 AsyncClient 可用 Transport 层挂 retry,但配置方式和 requests 完全不同
  • 别试图把 requests 的 Retry 对象传给 httpx.AsyncClient——类型不兼容,运行时报 TypeError
  • 真正要并发重试,优先考虑 httpx.AsyncClient + 自定义 transport,而不是在 asyncio 里塞 requests

重试不是加个参数就完事,关键在匹配真实失败原因:是 DNS 不稳?服务端偶发 503?还是客户端 socket 被复位?不同原因对应不同的 status_forcelist、allowed_methods 和 backoff_factor 组合。漏掉任意一环,重试就只是假装努力。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

580

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

876

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

1926

2025.08.19

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1818

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2884

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6204

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6029

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7634

2024.03.22

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

40

2026.10.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn