starlette 与 uvicorn 配合使用时,uvicorn 作为 asgi 服务器负责处理网络 i/o 和并发连接,而 starlette 应用实例则作为 asgi 可调用对象接收请求并返回响应。要启动服务,只需将 starlette 的 application 实例传给 uvicorn.run() 函数或命令行参数即可,uvicorn 会自动识别并调用该实例处理 http 请求。

如何配置 Uvicorn 以加载 Starlette 应用
通过命令行或 Python API 指定模块路径和变量名是加载 Starlette 应用的标准方式。使用 uvicorn main:app 命令时,Uvicorn 会导入 main.py 模块并查找名为 app 的变量,该变量必须是符合 ASGI 规范的 callable。这种方式无需修改 Starlette 代码本身,仅依赖正确的入口点声明。

import uvicorn
from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def homepage(request):
return PlainTextResponse("Hello World")
routes = [Route("/", homepage)]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
如何处理 Uvicorn 中的并发请求与生命周期事件
Uvicorn 基于 asyncio 实现高并发,每个请求在独立的协程中运行,Starlette 的路由系统按顺序匹配 URL 并执行对应的异步视图函数。当应用启动或关闭时,Uvicorn 会触发 Starlette 的生命周期钩子,允许开发者执行数据库连接池初始化或清理资源等操作,确保服务在并发环境下的稳定性。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

# 假设在上面的代码基础上添加生命周期管理
async def lifespan(app_state):
yield # 启动阶段
# 关闭阶段
app = Starlette(routes=routes, lifespan=lifespan)
Starlette 路由匹配失败时的具体行为是什么
当请求的 URL 无法匹配任何已注册的路由时,Starlette 会返回一个标准的 404 Not Found 响应。这种行为是内置的默认机制,开发者可以通过自定义 on_startup 或 on_shutdown 来扩展功能,但路由未命中时的异常处理逻辑依然遵循 ASGI 规范,直接返回错误状态码和相应内容。










