Uvicorn是ASGI协议的服务器实现,不绑定特定框架,只要应用符合ASGI规范(如FastAPI、Starlette、Sanic v22.3+、Quart≥0.18)即可直接运行,其核心只校验scope/receive/send三参数签名与异步可调用性。

Uvicorn 本身不“支持”某个框架,而是实现 ASGI 协议——只要框架输出符合 ASGI 规范(2.0 或 3.0)的可调用对象,就能直接跑在 Uvicorn 上。
FastAPI 和 Starlette 是最常用、开箱即用的选择
FastAPI 和 Starlette 都原生基于 ASGI 构建,它们的 app 实例本身就是标准的 ASGI callable:
- 类型是
async def(scope, receive, send)或可 await 的类实例 - 不需要额外适配或包装
-
uvicorn main:app可直启,无胶水代码
Sanic 从 v22.3+ 开始提供原生 ASGI 模式
早期 Sanic 是自研异步模型,不兼容 ASGI;但自 22.3 版本起:
Uvicorn 0.52.1 是 Python ASGI Web 服务器,提供异步应用服务及 WebSocket 支持,常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理所需依赖。
- 新增
app.serve()的 ASGI 入口(非默认) - 必须显式启用:
app = Sanic("myapp", configure_logging=False)+app.prepare(..., mode="asgi") - 否则仍走其私有 HTTP 服务器,无法与
Uvicorn协同
Quart(Python 的 Flask 异步版)需注意版本
-
Quart≥ 0.18 默认使用 ASGI 3 协议 - 低版本(如 0.11)用的是 ASGI 2,
Uvicorn仍能运行,但部分中间件(如某些asgi-correlation-id)可能报错 - 推荐检查:
print(app.<strong>class</strong>.<strong>module</strong>)确认是否为quart.app而非旧版quart.wrappers
自定义 ASGI 应用必须满足协议签名
哪怕只写三行,也得严格对齐:
- 参数名必须是
scope,receive,send(不能改名或加默认值) -
scope至少含"type","asgi","http_version"键 -
receive和send必须是 async callable,且不被提前 await(Uvicorn自己调度) - 常见翻车点:
async def app(): ...(少参数)、def app(...): async def inner(): ...(非顶层协程)
Uvicorn 的边界很清晰:它不管你是谁写的,只认协议。真正容易出问题的,往往不是框架选型,而是中间件混用时的事件循环绑定、或日志/错误处理逻辑意外阻塞了 asyncio 主线程。

















