starlette 通过中间件机制捕获全局异常,具体做法是自定义一个继承自 starlette.middleware.base.basehttpmiddleware 的类,并在其 dispatch 方法中用 try...except 包裹 await call_next(request)。这样所有未处理的异常都会被拦截,开发者可以在这里统一记录日志或返回标准化的错误响应,而无需在每个路由函数中单独处理。

如何注册并配置这个全局异常中间件
要生效上述逻辑,需要在创建 Starlette 应用实例后,调用 app.add_middleware 将自定义中间件类添加进去。通常建议放在其他业务中间件之前,以确保能捕获到最底层的原始异常。配置时只需传入中间件类本身,Starlette 会自动实例化并挂载到请求处理链上。

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.requests import Request
from starlette.responses import JSONResponse
class GlobalExceptionMiddleware(BaseHTTPMiddleware):
async def dispatch(self, request: Request, call_next):
try:
response = await call_next(request)
except Exception as exc:
# 记录异常日志
print(f"Caught exception: {exc}")
return JSONResponse(
status_code=500,
content={"message": "Internal Server Error"}
)
return response
app = Starlette()
app.add_middleware(GlobalExceptionMiddleware)
@app.route("/error")
async def raise_error(request):
raise ValueError("Something went wrong")
捕获到的异常对象包含哪些关键信息
在 except 块中捕获到的 exc 变量就是实际抛出的异常实例。它保留了完整的堆栈跟踪信息和原始错误类型,开发者可以检查 exc.__class__.__name__ 来区分不同类型的错误(如 ValueError、KeyError),或者访问 str(exc) 获取用户友好的错误描述。这些信息对于构建动态的错误响应或精细化日志至关重要。

# 在 dispatch 方法内部验证异常属性
try:
response = await call_next(request)
except Exception as exc:
error_type = exc.__class__.__name__ # 例如 "ValueError"
error_msg = str(exc) # 例如 "Something went wrong"
print(f"Type: {error_type}, Msg: {error_msg}")
如果异常发生在中间件链的其他位置会怎样
由于 BaseHTTPMiddleware 会将请求和响应包装在特定的流中,如果异常是在中间件链中更靠后的位置(如路由处理器)抛出的,call_next 会将其向上抛出至当前中间件的 except 块。但如果异常发生在当前中间件之前的其他中间件中,且那些中间件没有捕获,它们也会沿着调用栈向上传播,最终被最先遇到的未捕获异常处理点拦截。因此,确保全局异常中间件位于链的最外层或适当位置,是保证所有异常都能被统一处理的关键。

















