选择 starlette 是因为它轻量、标准且高性能,是构建现代 python web 应用和 api 的理想基础。安装与配置非常简单:通过 pip 安装 starlette 库,然后创建一个 asgi 应用实例并绑定路由即可运行。

Starlette 的核心架构优势是什么
Starlette 的核心优势在于其极简的 ASGI 兼容性和中间件支持。它不强制使用 ORM 或模板引擎,让开发者可以自由选择组件。这种设计使得它在处理高并发请求时表现优异,同时保持了代码的清晰和可维护性。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
async def homepage(request):
return JSONResponse({"hello": "world"})
routes = [
Route("/", homepage),
]
app = Starlette(routes=routes)
上述代码创建了一个简单的 Starlette 应用。当访问根路径时,它会返回一个 JSON 响应。这是 Starlette 最基础的用法,展示了其路由和响应的简洁性。
如何集成数据库和中间件
在 Starlette 中集成数据库和中间件非常灵活。你可以使用任何符合 ASGI 规范的中间件,如 CORS 或认证中间件。对于数据库,通常结合 SQLAlchemy 或 Tortoise ORM 使用,通过依赖注入或生命周期事件来管理连接。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.middleware.cors import CORSMiddleware
from starlette.applications import Starlette
from starlette.routing import Route
async def homepage(request):
return JSONResponse({"status": "ok"})
routes = [Route("/", homepage)]
app = Starlette(
routes=routes,
middleware=[
CORSMiddleware(app, allow_origins=["*"])
]
)
这段代码演示了如何在 Starlette 应用中添加 CORS 中间件。这使得应用能够接受来自不同域名的请求,常用于前后端分离的项目。中间件的添加方式直观且易于理解。
如何处理异步请求和错误
Starlette 原生支持异步,因此所有视图函数都应该是 async 的。对于错误处理,可以通过定义自定义异常处理器来实现。这允许你根据 HTTP 状态码返回特定的错误响应,提升用户体验。
from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import traceback
async def error_handler(request, exc):
return JSONResponse(
{"error": str(exc)},
status_code=500
)
async def homepage(request):
raise ValueError("Something went wrong")
routes = [Route("/", homepage)]
app = Starlette(
routes=routes,
on_startup=[],
on_shutdown=[],
exception_handlers={Exception: error_handler}
)
这个示例展示了如何捕获未处理的异常并返回友好的错误信息。通过注册 `exception_handlers`,你可以控制不同异常类型的响应格式。这对于调试和生产环境都非常有用。

















