0

0

Python 服务间调用超时与重试策略

舞姬之光

舞姬之光

发布时间:2026-02-15 15:22:31

|

977人浏览过

|

来源于php中文网

原创

必须显式设置timeout并拆分为(connect_timeout, read_timeout)二元组,connect设3~5秒,read略大于下游p99;重试需用session+urllib3.retry配置,仅针对网络异常及502/503/504,配合backoff_factor和总次数≤3。

python 服务间调用超时与重试策略

requests 调用下游服务时 timeout 参数到底怎么设

不设 timeout 就等于把命交给网络——超时可能卡住整个线程,尤其在高并发下拖垮服务。Python 的 requests 默认不设超时,这是最常被忽略的隐患。

必须显式传入 timeout,且推荐拆成 (connect_timeout, read_timeout) 二元组:

  • connect_timeout 控制 TCP 连接建立时间,一般设 35 秒足够;太短容易误判网络抖动,太长会拖慢失败感知
  • read_timeout 控制从建立连接后读取响应的时间,应略大于下游服务 P99 响应时长(比如下游 P99 是 800ms,这里设 1.52.0
  • 只传单个数字(如 timeout=5)等价于 (5, 5),但 connect 和 read 场景差异大,合并不灵活
  • 设成 timeout=None 或完全不传,等于无限等待,生产环境严禁

重试不是加个 retry=True 就完事

requests 自带的 Retry 类得手动配,直接写 retry=True 会报错——它根本不是 requests.get() 的参数。

正确做法是构造 Session + urllib3.Retry,关键点在状态码和异常类型的区分:

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

灵图AI
灵图AI

灵图AI辅助设计平台

下载
  • 只对可重试错误重试:网络层异常(ConnectTimeoutReadTimeoutConnectionError)和部分 HTTP 状态码(502503504),别盲目重试 400401
  • backoff_factor 必须设(比如 0.3),否则重试是“秒连三发”,可能加剧下游雪崩
  • 总重试次数建议 ≤3,再高意义不大,反而延长用户等待
  • 示例片段:
    from requests.adapters import HTTPAdapter<br>from urllib3.util.retry import Retry<br><br>session = requests.Session()<br>retry_strategy = Retry(<br>    total=3,<br>    status_forcelist=(502, 503, 504),<br>    backoff_factor=0.3<br>)<br>adapter = HTTPAdapter(max_retries=retry_strategy)<br>session.mount("http://", adapter)<br>session.mount("https://", adapter)

异步调用(aiohttp)里 timeout 和 retry 更容易漏配

aiohttpClientTimeout 和重试逻辑默认全关,不像 requests 至少还有个显眼的 timeout 参数提醒你。

两个硬性动作不能省:

  • 创建 ClientTimeout 实例并传给 ClientSession,例如 timeout=ClientTimeout(total=10, connect=3, sock_read=7);不传就按默认 5m 总超时,线上几乎等于没设
  • 重试得自己写循环或用 tenacity 这类库,aiohttp 本身不提供内置重试;简单轮询要注意加 await asyncio.sleep() 避免空打
  • 注意 raise_for_status() 抛出的是 aiohttp.ClientResponseError,不是 requests.HTTPError,类型判断别写错
  • 并发请求下,每个 ClientSession 应复用,别在每次请求里新建——否则 DNS 缓存、连接池全失效

超时与重试组合导致的隐蔽问题

你以为设了 3 秒超时 + 3 次重试,最多耗时 9 秒?错。实际可能是 3 × (3s connect + 7s read) = 30 秒,而且中间还夹着退避延迟。

真正要控制的是端到端最大耗时,所以必须做两件事:

  • 用外层 asyncio.wait_for()(异步)或 signal.alarm() / concurrent.futures.wait()(同步)兜底,强制截断整条调用链
  • 重试时记录原始开始时间,每次重试前检查是否已超全局 deadline,避免“重试到一半才发现来不及”
  • 下游返回 Retry-After 头时,优先按它来休眠,而不是死守 backoff_factor
  • 日志里必须同时打上「发起时间」「重试次数」「当前 timeout 设置」,否则出问题根本分不清是下游慢、重试策略失控,还是上游压根没设限

超时和重试从来不是独立配置项,它们和你的服务 SLA、下游稳定性、熔断阈值是一体的。少一个环节对齐,线上就多一分不可控。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

325

2023.10.17

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

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

772

2023.10.18

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

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

96

2025.08.19

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

673

2023.08.10

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

464

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

435

2023.11.14

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

3063

2024.03.12

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2519

2024.08.16

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

76

2026.02.13

热门下载

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

精品课程

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

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

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

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