复用ClientSession时aiohttp请求失败 仅首次请求正常如何排查？

核心原因 #

• ClientSession 默认开启TCP连接池与HTTP keep-alive机制，会复用同一个TCP连接发起多次请求。如果第三方服务端的keep-alive实现存在缺陷，无法正确解析同一连接上的后续请求，就会返回500错误。每次新建ClientSession时会初始化独立的连接池，每次请求都新建TCP连接，因此不会触发该问题。
• ClientSession 默认会自动持久化服务端返回的Cookie，同个session的后续请求会自动携带之前存储的所有Cookie，部分服务端逻辑未兼容额外的Cookie参数，处理异常后返回500。

排查验证步骤 #

你可以通过修改ClientSession的初始化参数定位具体原因：

1. 先测试禁用Cookie持久化，初始化时指定空Cookie容器：

import aiohttp
session = aiohttp.ClientSession(cookie_jar=aiohttp.DummyCookieJar())

如果修改后复用session可正常发起多次请求，说明问题根源是服务端对请求携带的Cookie处理异常。
2. 如果禁用Cookie后仍报错，测试关闭keep-alive，每次请求结束后强制关闭TCP连接：

import aiohttp
session = aiohttp.ClientSession(connector=aiohttp.TCPConnector(force_close=True))

如果修改后请求正常，说明是服务端keep-alive实现存在兼容性问题。

代码优化建议 #

你当前手动拼接x-www-form-urlencoded格式请求体的方式存在特殊字符未转义的风险，建议改用aiohttp自带的表单构造能力：

from aiohttp import FormData

# 构造表单数据
form = FormData()
form.add_field("Authorization", f"Bearer {token}")
# 其余原有表单参数逐个调用add_field添加即可

resp = await session.post(
    url,
    data=form,
    headers={"accept": "application/json"}
)

如果第三方接口允许，建议将Authorization参数移至请求头中，更符合REST API的通用设计规范，避免放在请求体中出现编码问题。

内容的提问来源于stack exchange，提问作者miguel.camba