requests 如何在重试时保留原 Session 的所有 cookie 和 header

正确做法是复用同一个 Session 实例并配置 Retry,Session 会自动管理 cookie 和保留 headers,所有请求(含重试)均继承这些状态。

使用 requests 重试时保留原

始 Session 的所有 cookie 和 header,关键在于**复用同一个 Session 实例**,并确保重试逻辑不干扰其内部状态(如 cookiesheaders 和连接池)。默认的 requests.adapters.HTTPAdapter 重试机制天然支持这一点——它不会清空或覆盖 Session 的 cookie 或自定义 header。

✅ 正确做法:用同一个 Session + Retry 配置

Session 对象本身会自动管理 cookie(自动存储响应中的 Set-Cookie,并在后续请求中带上),也会保留你通过 session.headers.update(...) 设置的默认 header。只要重试是通过该 Session 发起的,这些状态全程有效。

  • 创建一个 requests.Session() 实例
  • 设置你需要的默认 headers(如 User-AgentAuthorization
  • 配置 HTTPAdapter 并启用 Retry,挂载到 session 的 mount 点
  • 所有 session.get() / session.post() 调用都会自动携带 cookie 和 header,并在重试时保持不变

示例代码:

import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

session = requests.Session() session.headers.update({ "User-Agent": "MyApp/1.0", "X-Client-ID": "abc123" })

配置重试策略(最多重试 3 次,遇到 5xx 或网络错误就重试)

retry_strategy = Retry( total=3, status_forcelist=[429, 500, 502, 503, 504], backoff_factor=1, ) adapter = HTTPAdapter(max_retries=retry_strategy) session.mount("http://", adapter) session.mount("https://", adapter)

第一次请求登录,服务端返回 Set-Cookie → 自动存入 session.cookies

resp1 = session.post("https://www./link/052c3ffc93bd3a4d5fc379bf96fabea8", json={"u": "a", "p": "b"})

后续请求(含重试)自动携带登录态 cookie 和你设的 headers

resp2 = session.get("https://www./link/46b315dd44d174daf5617e22b3ac94ca") # 即使失败重试,cookie 和 headers 不变

⚠️ 常见错误:手动新建 Request 或绕过 Session

以下写法会丢失 cookie 和 header:

  • requests.get(...)(没用 session)→ 每次都是全新 request,无状态
  • session.prepare_request(req) 手动构造再发 → 若未显式传入 cookiesheaders,容易遗漏
  • 在重试回调里 new 一个 session → 彻底丢弃原有上下文

? 验证是否生效的小技巧

调试时可打印关键字段确认:

  • print(session.cookies) —— 查看当前已存储的 cookies
  • print(session.headers) —— 确认默认 headers 是否还在
  • 开启 logging 看底层请求(urllib3)是否带了 Cookie: 和自定义 header

? 进阶:需要动态 header 或 cookie?

如果某些 header 或 cookie 需每次请求前计算(如 token 过期需刷新),不要直接改 session.headers,而是:

  • session.request(method, url, headers={...}) 显式传入动态值(会与默认 headers 合并)
  • 对 cookie,可先调 session.cookies.set(...) 更新,再发请求
  • 避免在重试中间修改 session 状态,否则可能影响重试行为的一致性