安装 starlette 需要运行 pip install starlette,基础设置则是实例化 starlette 对象并注册路由。通过继承 requestresponseendpoint 或定义普通函数作为处理程序,可以构建最小应用。若需处理异步请求,确保处理函数使用 async def。

如何配置 Starlette 的路由系统以匹配特定路径?
配置路由的核心是使用 add_route 方法将 URL 模式与处理函数绑定。Starlette 的路由器支持路径参数(如 {id})和正则表达式匹配。在初始化 Starlette 实例后,调用 app.add_route('/users/{user_id}', get_user) 即可生效。路由器会按添加顺序进行匹配,因此更具体的路由应放在前面。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import asyncio
async def homepage(request):
return JSONResponse({"message": "Hello World"})
async def get_user(request):
user_id = request.path_params["user_id"]
return JSONResponse({"user_id": user_id})
routes = [
Route("/", endpoint=homepage),
Route("/users/{user_id}", endpoint=get_user),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
import uvicorn
uvicorn.run(app, host="0.0.0.0", port=8000)
预期结果:访问根路径返回 {"message": "Hello World"},访问 /users/123 返回 {"user_id": "123"}。服务器监听在 8000 端口。
立即学习“Python免费学习笔记(深入)”;
如何处理 Starlette 中的中间件栈?
中间件用于在请求到达路由前或响应返回客户端前执行通用逻辑。通过 app.add_middleware 添加中间件,它们按 LIFO(后进先出)顺序执行。例如,添加 Middleware(HTTPSRedirectMiddleware) 可强制 HTTPS。自定义中间件需实现 __call__ 方法,接收 request 并返回 response。中间件可以修改请求头、记录日志或处理异常。

from starlette.applications import Starlette
from starlette.middleware import Middleware
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def homepage(request):
return PlainTextResponse("Home")
class LoggingMiddleware(BaseHTTPMiddleware):
async def dispatch(self, request, call_next):
print(f"Processing: {request.method} {request.url}")
response = await call_next(request)
print(f"Response status: {response.status_code}")
return response
routes = [Route("/", homepage)]
app = Starlette(
routes=routes,
middleware=[Middleware(LoggingMiddleware)]
)
预期结果:每次请求都会打印处理信息和响应状态码。中间件包裹了路由处理逻辑。
当 Starlette 路由中缺少必需的路径参数时会发生什么?
如果请求路径与路由模式不匹配,例如访问 /users 而路由定义为 /users/{user_id},Starlette 会返回 404 Not Found。这是因为路由器无法提取 user_id 参数。若参数类型不匹配(如期望整数但收到字符串),且未做类型转换,可能在处理函数中引发错误。建议在处理函数中显式转换或验证参数类型。


















