25、FastAPI 高级特性应用指南

FastAPI 高级特性应用指南

1. 会话管理

1.1 会话数据管理

在基于 APIKeyCookie 的会话认证中，添加和检索会话数据并非其一部分。JWT 负载仅应包含用户名，而非所有凭证和数据主体。若要管理会话数据，需使用 Starlette 的 SessionMiddleware 创建单独的会话。即便 FastAPI 有自身的 fastapi.middleware 模块，它仍支持 Starlette 的内置中间件。

在 main.py 模块（FastAPI 实例所在之处）实现、配置并激活中间件，因为 APIRouter 无法添加中间件。可通过启用 FastAPI 构造函数的 middleware 参数，并使用可注入类 Middleware 将内置的 SessionMiddleware 添加到该列表类型参数中，同时传入 secret_key 和新会话的名称作为构造函数参数。以下是 main.py 的配置代码示例：

from starlette.middleware.sessions import SessionMiddleware
from fastapi import FastAPI, Request, Depends
from fastapi.routing import APIRouter
from typing import List

# 假设的依赖函数
def creat