starlette 通过 `@app.route()` 装饰器将路径操作函数绑定到特定的 http 方法和 url 模式上。你需要实例化一个 `starlette` 或 `fastapi` 应用对象,然后使用装饰器指定路径字符串和请求方法(如 `get`、`post`),被装饰的函数即可处理对应的路由请求。

如何定义支持 GET 请求的路由
要处理 GET 请求,只需在装饰器中指定 `methods=["GET"]` 或直接省略 methods 参数(默认包含 GET)。函数接收 `Request` 对象作为参数,并返回 `Response` 对象或其子类。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
from starlette.requests import Request
async def homepage(request: Request):
return JSONResponse({"message": "Hello World"})
routes = [
Route("/", endpoint=homepage, methods=["GET"]),
]
app = Starlette(routes=routes)访问根路径 `/` 时,服务器将返回 JSON 格式的 `{"message": "Hello World"}` 响应。
如何定义支持 POST 请求的路由
处理 POST 请求需要显式声明 `methods=["POST"]`。通常需要从 `request.json()` 或 `request.form()` 中解析数据,并返回相应的结果。如果请求体格式错误,可以捕获异常并返回错误响应。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

async def create_item(request: Request):
try:
data = await request.json()
item_id = data.get("id")
return JSONResponse({"created": True, "id": item_id})
except Exception as e:
return JSONResponse({"error": str(e)}, status_code=400)
routes = [
Route("/items", endpoint=create_item, methods=["POST"]),
]向 `/items` 发送 POST 请求并携带 JSON 数据 `{"id": 123}` 时,将返回 `{"created": true, "id": 123}`;若发送无效 JSON,则返回 400 状态码及错误信息。
当路径中包含动态参数时会发生什么
如果在路径字符串中使用花括号包裹变量名(如 `
async def get_item(request: Request):
item_id = request.path_params["item_id"]
return JSONResponse({"item_id": item_id})
routes = [
Route("/items/{item_id}", endpoint=get_item, methods=["GET"]),
]访问 `/items/42` 时,`path_params` 字典中将包含 `{"item_id": "42"}`,函数返回 `{"item_id": "42"}`。注意参数值始终为字符串类型,如需整数需手动转换。

















