在Python的网络请求场景中,Cookie是维持用户会话状态的核心机制,而requests库的Session对象提供了便捷的Cookie管理能力,能够轻松实现登录状态的保持。很多需要登录后才能访问的接口,本质上都是通过验证请求携带的Cookie来判断用户是否处于登录态。

Cookie基础概念
Cookie是服务器发送到用户浏览器并保存在本地的一小块数据,它会在浏览器后续向同一服务器发起请求时被携带发送。在HTTP请求中,Cookie通常放在请求头的Cookie字段中,服务器通过解析这个字段来识别用户身份、维持会话。
原生Cookie操作方式
如果不使用Session,我们也可以手动处理Cookie,不过这种方式需要自己维护Cookie的存储和传递,比较繁琐。以下是一个手动获取和携带Cookie的示例:
import requests
# 登录接口地址
login_url = "http://127.0.0.1:8080/login"
# 登录参数
login_data = {
"username": "test_user",
"password": "test_pass123"
}
# 发送登录请求
response = requests.post(login_url, data=login_data)
# 获取服务器返回的Cookie
cookies = response.cookies
print("登录后获取的Cookie:", cookies)
# 访问需要登录的接口,手动携带Cookie
target_url = "http://127.0.0.1:8080/user_info"
# 将获取的Cookie添加到请求中
response = requests.get(target_url, cookies=cookies)
print("携带Cookie请求的结果:", response.text)
使用requests.Session保持登录状态
requests的Session对象会自动处理Cookie的存储和携带,在同一个Session实例中发送的所有请求,都会自动带上之前请求中服务器返回的Cookie,非常适合用来维持登录状态。
Session基本使用流程
使用Session保持登录状态的核心步骤只有两步:首先创建Session实例,然后用这个实例发送登录请求,之后再用同一个实例发送其他需要登录的接口请求即可。
import requests
# 创建Session实例
session = requests.Session()
# 第一步:发送登录请求,Session会自动保存登录后返回的Cookie
login_url = "http://127.0.0.1:8080/login"
login_data = {
"username": "test_user",
"password": "test_pass123"
}
login_resp = session.post(login_url, data=login_data)
print("登录响应状态码:", login_resp.status_code)
# 第二步:使用同一个Session实例访问需要登录的接口,自动携带Cookie
target_url = "http://127.0.0.1:8080/user_info"
target_resp = session.get(target_url)
print("登录后访问接口的结果:", target_resp.text)
# 查看Session当前保存的所有Cookie
print("Session保存的Cookie:", session.cookies)
Session的Cookie管理特性
- 自动存储:Session在发送请求后,会自动保存响应头中
Set-Cookie字段返回的Cookie。 - 自动携带:Session后续发送的所有请求,都会自动把保存的Cookie放到请求头的
Cookie字段中。 - 持久化支持:如果需要长期保存Session的Cookie,可以将
session.cookies的内容序列化到本地,下次使用时再加载,实现跨进程的登录态保持。
Session Cookie的持久化示例
如果需要在程序重启后仍然保持登录状态,可以将Session的Cookie保存到本地文件中,下次运行时重新加载即可:
import requests
import pickle
import os
cookie_file = "session_cookies.pkl"
def save_cookies(session, file_path):
"""保存Session的Cookie到本地文件"""
with open(file_path, "wb") as f:
pickle.dump(session.cookies, f)
def load_cookies(file_path):
"""从本地文件加载Cookie到新的Session"""
if os.path.exists(file_path):
with open(file_path, "rb") as f:
return pickle.load(f)
return None
# 创建Session
session = requests.Session()
# 尝试加载本地保存的Cookie
saved_cookies = load_cookies(cookie_file)
if saved_cookies:
session.cookies.update(saved_cookies)
print("已加载本地保存的Cookie")
else:
# 没有本地Cookie则重新登录
login_url = "http://127.0.0.1:8080/login"
login_data = {
"username": "test_user",
"password": "test_pass123"
}
session.post(login_url, data=login_data)
# 保存登录后的Cookie到本地
save_cookies(session, cookie_file)
print("登录完成,已保存Cookie到本地")
# 测试访问需要登录的接口
target_url = "http://127.0.0.1:8080/user_info"
resp = session.get(target_url)
print("接口返回结果:", resp.text)
常见问题说明
注意:如果服务器返回的Cookie有有效期限制,过期后即使携带Cookie也会被判定为未登录,这时候需要重新执行登录流程获取新的Cookie。
另外,部分网站会对Cookie进行加密或者添加额外的验证字段,比如User-Agent、Referer等请求头,使用Session时也需要根据目标网站的要求,补充对应的请求头信息,避免被服务器判定为异常请求。
Python_Cookierequests.Session保持登录状态HTTP请求修改时间:2026-06-21 23:36:30