starlette 本身没有拦截器概念,应使用中间件实现请求拦截与响应修改。通过继承 starlette.middleware.base.basehttpmiddleware 并重写 dispatch 方法,可以在请求到达路由前或响应返回客户端前执行自定义逻辑。

如何定义并注册一个基础中间件
定义中间件需继承 BaseHTTPMiddleware,在 dispatch 中调用 await call_next(request) 获取响应对象,随后修改响应头或状态码后返回。注册时通过 app.add_middleware() 将中间件类加入应用栈,确保它在路由处理之前生效。

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
from starlette.applications import Starlette
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.responses import Response
from starlette.requests import Request
class CustomInterceptor(BaseHTTPMiddleware):
async def dispatch(self, request: Request, call_next):
# 请求前逻辑
print(f"Processing request: {request.url.path}")
response = await call_next(request)
# 响应后逻辑
response.headers['X-Custom-Header'] = 'intercepted'
return response
app = Starlette()
app.add_middleware(CustomInterceptor)
如何处理异常并返回自定义错误响应
在 dispatch 方法中使用 try...except 块包裹 call_next 调用,捕获可能抛出的异常。当异常发生时,直接构造并返回一个自定义的 Response 对象,从而阻止默认的错误传播机制,实现统一的错误拦截效果。

from starlette.applications import Starlette
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.responses import JSONResponse
from starlette.requests import Request
class ErrorInterceptor(BaseHTTPMiddleware):
async def dispatch(self, request: Request, call_next):
try:
response = await call_next(request)
return response
except Exception as exc:
return JSONResponse(
status_code=500,
content={"error": str(exc)}
)
app = Starlette()
app.add_middleware(ErrorInterceptor)
基于中间件中 request.state 的具体问题
在中间件中可以通过 request.state 对象存储自定义数据,供后续路由或视图函数访问。例如在拦截器中解析认证令牌并将用户信息存入 request.state.user,这样下游代码无需重复解析即可获取当前用户身份,实现跨层数据传递。

















