Flask 2.x 本身不提供请求重试机制，因其仅处理入站请求，而出站调用第三方 API 的重试需由 requests + urllib3 的 Retry 类或 tenacity 等库实现，须区分连接/读取超时、精准配置 status_forcelist 和异常类型，并复用 Session 避免性能损耗。
Flask 2.x 本身不提供请求重试机制
Flask 是一个 Web 框架，负责处理**入站请求**（如用户发来的 HTTP 请求），它不主动发起出站 HTTP 请求，因此 Flask 自身没有、也不需要内置“接口请求重试”功能。你真正需要的是：在 Flask 应用内部调用第三方 API（比如用 requests）时，为这些出站调用添加重试逻辑。
常见错误现象是：直接在路由函数里写 requests.get(url)，但网络抖动或下游服务短暂不可用时，整个接口直接报错返回 500 或空响应，用户体验差且无兜底。
用 requests + urllib3 的 Retry 配置最轻量可靠
Python 标准库不带重试，但 requests 底层依赖 urllib3，其 Retry 类可直接复用，无需引入额外包（如 tenacity），适合多数中低频调用场景。
-
Retry实例需传给requests.Session的mount方法，不能只配一次requests.get() - 重试仅对特定状态码生效，默认不重试 4xx（比如
404或400），需显式通过status_forcelist开启（如加上502,503,504） - 注意连接超时（
connect）和读取超时（read）要分开设，否则网络卡顿时可能等很久才触发重试 - 示例配置：
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
import requests
<p>session = requests.Session()
retry_strategy = Retry(
total=3,
status_forcelist=(502, 503, 504),
backoff_factor=1,
allowed_methods=["GET", "POST"] # 注意：2.26+ 版本默认禁用 POST 重试，必须显式声明
)
adapter = HTTPAdapter(max_retries=retry_strategy)
session.mount("http://", adapter)
session.mount("https://", adapter)</p><h1>在 Flask 路由中使用</h1><p>@app.route("/data")
def get_data():
try:
resp = session.get("<a href="https://www.php.cn/link/4160090a26bf2b0296821aed16f33f51">https://www.php.cn/link/4160090a26bf2b0296821aed16f33f51</a>", timeout=(3, 10))
return resp.json()
except requests.RequestException as e:
return {"error": "upstream failed"}, 502
</p>
重试逻辑别放在每次请求里初始化 Session
如果在每个路由函数里都新建 Session 和 Retry，不仅性能浪费（TCP 连接池失效），还会让重试统计、熔断等后续扩展变得困难。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 把
session声明为模块级全局变量，或用 Flask 的app.extensions注册（更规范） - 避免在重试过程中修改请求体（比如含时间戳或 nonce 的 POST），否则重试会发重复/非法请求
- 不要对非幂等操作（如支付、下单）盲目加自动重试，应优先设计成可查证、可补偿
- 如果下游接口明确返回
Retry-After头，urllib3.Retry默认不识别它——得自己解析并 sleep，此时建议切到tenacity手动控制流程
调试时务必开启 urllib3 日志看真实重试行为
光看返回值无法确认是否真重试了。很多开发者以为配了就生效，结果发现失败仍只调一次——其实是状态码没进 status_forcelist，或异常类型根本没被捕获（比如 DNS 解析失败属于 ConnectionError，不是 HTTP 状态码）。
- 加这三行就能看到每次重试的详细日志：
import logging logging.basicConfig(level=logging.DEBUG) requests.packages.urllib3.add_stderr_logger()
你会看到类似 Retrying (Retry(total=2, ...)) after connection broken by 'NewConnectionError(...)'... 的输出。没看到？说明重试根本没触发，回头检查 status_forcelist、异常类型、或是否用了 session。
真正的难点不在“怎么加”，而在判断哪些错误该重试、重试几次合理、失败后要不要降级返回缓存——这些没法靠一个 Retry 对象解决，得结合业务 SLA 来定。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
