starlette 是一个轻量级的 asgi 框架,安装后通过实例化 starlette 类并定义路由即可快速启动服务。具体做法是调用 pip install starlette uvicorn 安装依赖,然后创建一个应用对象,使用 @app.route() 装饰器绑定路径与处理函数,最后用 uvicorn 运行该应用。若未指定端口,默认监听 8000。

如何定义一个返回 JSON 的路由
在 Starlette 中,可以通过导入 JSONResponse 来构建结构化数据响应。开发者只需在处理函数中实例化 JSONResponse 并传入字典,框架会自动设置正确的 Content-Type 头。这种方式比直接返回字符串更规范,适合 API 开发场景。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn
async def hello_world(request):
return JSONResponse({"message": "Hello World"})
routes = [
Route("/", handler=hello_world),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="0.0.0.0", port=8000)
如何处理 URL 路径参数
Starlette 支持在路由定义中使用花括号语法捕获路径变量。例如定义 /users/{user_id},处理函数接收到的 request 对象包含 path_params 属性,其中存储了解析后的键值对。这种机制允许动态生成针对不同资源的响应内容。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn
async def get_user(request):
user_id = request.path_params["user_id"]
return JSONResponse({"user_id": user_id, "status": "found"})
routes = [
Route("/users/{user_id}", handler=get_user),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="0.0.0.0", port=8000)
当请求方法不匹配时会发生什么
如果客户端发送的请求方法与路由定义的方法不一致,Starlette 会返回 405 Method Not Allowed 状态码。这是因为路由匹配逻辑严格区分 GET、POST 等 HTTP 动词。开发者可以通过检查响应的 status_code 来确认这一行为,或者在路由中同时注册多个方法来支持多种请求类型。










