选择 starlette 是因为它提供了轻量级、高性能的 asgi 接口,能够作为 fastapi 等高级框架的底层支撑,同时支持 websocket 和 http/2,适合构建高并发异步应用。安装与配置的核心步骤是:使用 pip install starlette uvicorn 安装依赖,创建继承自 starlette 或 application 的应用实例,添加路由并启动 uvicorn 服务器。

如何定义基础路由与请求处理?
在 Starlette 中,通过 add_route 方法将 URL 路径映射到具体的异步函数。开发者需要定义一个接受 request 参数的函数,返回 Response 对象。这种方式允许直接访问 ASGI 环境,提供细粒度的控制。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn
async def homepage(request):
return JSONResponse({"hello": "world"})
routes = [
Route("/", homepage),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
运行上述代码后,访问 http://127.0.0.1:8000/ 将返回 JSON 数据。预期结果为 {"hello": "world"},状态码为 200。
如何处理动态路径参数?
Starlette 支持在路由中使用尖括号语法定义路径参数,如 /items/{item_id}。当请求匹配该模式时,框架会自动解析参数并传递给处理函数。这简化了 RESTful API 的开发,无需手动解析 URL 字符串。
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_item(request):
item_id = request.path_params["item_id"]
return JSONResponse({"item_id": item_id})
routes = [
Route("/items/{item_id}", get_item),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
访问 http://127.0.0.1:8000/items/42 将返回 {"item_id": "42"}。注意参数值始终为字符串类型,需在业务逻辑中转换。
基于程序中某个输入、条件或结果的具体问题
当请求路径包含未定义的路径参数时,Starlette 会抛出 HTTPException 或返回 404 错误。例如,若路由定义为 /items/{item_id},但请求 /items(无参数),则不会匹配该路由,除非显式定义了 /items 路由。这种严格匹配机制确保了路径参数的必要性,避免歧义。










