Uvicorn原生支持ASGI协议，专为FastAPI等异步应用设计，直接解析网络字节流为ASGI事件，无需桥接层；相比Gunicorn+UvicornWorker组合，性能高15%~20%，且开箱支持HTTP/2、WebSocket和流式响应。
Uvicorn原生支持ASGI协议，FastAPI是ASGI应用
FastAPI不是WSGI应用，它定义的是一个异步可调用对象，签名是async def app(scope, receive, send)。Uvicorn就是为这种接口设计的——它不经过任何桥接层，直接把网络字节流解析成ASGI事件，再喂给FastAPI的app。而Gunicorn这类WSGI服务器要跑FastAPI，必须用uvicorn.workers.UvicornWorker做一层转译，多一次事件循环调度、多一次协程包装，实测RPS低15%~20%。
常见错误现象：gunicorn -k uvicorn.workers.UvicornWorker main:app能跑通，但压测时延迟毛刺明显，async函数里await数据库查询反而比同步还慢——问题常出在worker间事件循环隔离不彻底，或Gunicorn主进程干扰了uvloop调度。
--reload热重载由Uvicorn原生实现，稳定可靠
Uvicorn的--reload是reloader进程+worker进程双进程模型，reloader只监听Python文件变动，触发后杀掉旧worker、拉起新worker。整个过程不依赖应用代码重载机制，不会出现模块残留、类单例错乱、全局变量重复初始化等问题。
使用场景下要注意：
- 务必用
--reload-dir限定路径，比如uvicorn main:app --reload --reload-dir ./app --reload-dir ./models，否则改tests/或docs/也会重启 - Windows下避免在PyCharm调试器里直接点运行按钮，IDE会接管进程导致inotify失效；改用终端执行
python -m uvicorn main:app --reload -
--reload绝对不能进Docker容器——镜像层只读，inotify监听会静默失败或报Permission denied
单进程性能高、内存占用低，开发体验更轻量
Uvicorn默认只启一个worker进程+一个uvloop事件循环线程，无额外管理进程开销。对比Gunicorn（master + 多worker），同样硬件下内存少占30MB以上，启动快800ms左右，对笔记本开发很友好。
Uvicorn 0.52.1 是 Python ASGI Web 服务器，提供异步应用服务及 WebSocket 支持，常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包，可使用 pip 安装，并由包管理器处理所需依赖。
但这也带来一个容易被忽略的点：它默认不利用多核。开发阶段无所谓，但如果你在本地用--workers 4测试多进程行为，得清楚这和生产部署的gunicorn+uvicorn组合不是一回事——Uvicorn的--workers是fork模式，各worker之间不共享状态，也没有Gunicorn的优雅重启钩子。
参数差异举例：
-
uvicorn main:app --workers 4：fork出4个独立Uvicorn进程，每个都带完整事件循环 -
gunicorn -k uvicorn.workers.UvicornWorker -w 4 main:app：Gunicorn master管理4个Uvicorn worker，有统一信号处理和健康检查
HTTP/2、WebSocket、流式响应开箱即用
Uvicorn底层用httptools（C语言）解析HTTP，原生支持HTTP/2帧解析、WebSocket握手升级、分块传输编码（chunked encoding）。FastAPI的StreamingResponse、EventSourceResponse、@app.websocket这些能力，全靠Uvicorn在协议层兜底。
如果换用其他ASGI服务器（比如Daphne或Hypercorn），可能需要手动开启--http http2或额外配TLS ALPN，而Uvicorn默认就启用HTTP/2支持（只要证书配置正确）。不过注意：本地开发用http://时HTTP/2不会生效，必须上https://且客户端支持ALPN协商。
真正容易被忽略的是异常传播链：Uvicorn把未捕获的async异常直接抛给事件循环，可能导致连接卡在CLOSE_WAIT状态而不释放。FastAPI里一定要用try/except包住await调用，或配全局异常处理器，否则长连接接口会悄悄堆积空闲连接。
