starlette 集成 redis 缓存的核心做法是借助 aioredis(或 redis-py 的异步接口)建立连接池,并通过自定义中间件拦截请求。在中间件中,先检查 redis 中是否存在对应的缓存键;若存在则直接返回缓存内容并跳过业务逻辑,若不存在则执行视图函数、获取响应数据并存入 redis,最后返回响应。

如何构建支持异步操作的 Redis 连接池
要实现高效的缓存集成,必须使用异步客户端来管理连接。推荐使用 redis.asyncio 模块创建单例连接池,确保在整个应用生命周期内复用 TCP 连接,避免频繁握手带来的性能损耗。

import redis.asyncio as aioredis
from starlette.applications import Starlette
from starlette.routing import Route
# 全局连接池
redis_pool = None
async def get_redis():
global redis_pool
if redis_pool is None:
redis_pool = aioredis.from_url(
"redis://localhost:6379",
encoding="utf-8",
decode_responses=True
)
return redis_pool
async def homepage(request):
return {"message": "Hello World"}
app = Starlette(routes=[Route("/", homepage)])
如何编写缓存中间件以拦截请求与响应
通过继承 starlette.middleware.base.BaseHTTPMiddleware 并重写 dispatch 方法,可以精确控制请求的生命周期。在 dispatch 中,我们提取请求的唯一标识(如 URL 和查询参数),将其作为 Redis 的 Key。如果命中缓存,直接构造并返回 Response 对象;否则,调用 await call_next(request) 执行后续路由逻辑,获取响应后序列化存入 Redis,再返回该响应。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

import json
import hashlib
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.responses import Response
from starlette.requests import Request
class CacheMiddleware(BaseHTTPMiddleware):
def __init__(self, app, redis_client, ttl=60):
super().__init__(app)
self.redis = redis_client
self.ttl = ttl
async def dispatch(self, request: Request, call_next):
# 生成缓存键
key = self.generate_key(request)
# 尝试从 Redis 获取缓存
cached_response = await self.redis.get(key)
if cached_response:
data = json.loads(cached_response)
return Response(content=data["body"], status_code=data["status"])
# 执行原始请求
response = await call_next(request)
# 将响应存入 Redis
body = b""
async for chunk in response.body_iterator:
body += chunk
cache_data = {
"body": body.decode("utf-8"),
"status": response.status_code
}
await self.redis.setex(key, self.ttl, json.dumps(cache_data))
return Response(content=body, status_code=response.status_code)
def generate_key(self, request: Request):
# 简单哈希策略:URL + QueryString
raw = f"{request.method}:{request.url.path}:{request.query_params}"
return f"cache:{hashlib.md5(raw.encode()).hexdigest()}"
如何处理 POST 请求及动态参数的缓存失效问题
对于非幂等的 POST 请求,通常不应进行缓存,或者需要更复杂的失效策略。在上述中间件实现中,可以通过判断 request.method 来跳过缓存逻辑。此外,当数据更新时,需主动删除对应的 Redis Key 以保证一致性。例如,在用户修改资料后,调用 await redis.delete(f"cache:{user_hash}") 即可使旧缓存失效,下次访问时将重新生成。










