Uvicorn是Python生态中常用的轻量级ASGI服务器,广泛应用于FastAPI、Starlette等异步Web框架的部署场景。默认启动的Uvicorn实例仅运行在单个进程中,只能使用单个CPU核心处理请求,当业务流量上升时很容易达到性能上限。为了突破单进程的性能限制,Uvicorn提供了原生的多进程支持能力,通过启动多个工作进程来实现HTTP请求的并发处理,充分利用服务器的多核CPU资源。

Uvicorn多进程的核心实现原理
Uvicorn的多进程能力基于Python标准库的multiprocessing模块实现,整体采用主进程加多个工作进程的架构模式:
- 主进程负责启动和管理所有工作进程,监听工作进程的运行状态,当工作进程异常退出时会自动拉起新的进程补充
- 每个工作进程都是独立的Uvicorn实例,会独立加载ASGI应用,绑定到相同的监听端口,各自处理接收到的HTTP请求
- 底层依赖操作系统的端口复用机制,多个进程可以同时监听同一个端口,由操作系统内核负责将新到来的请求分配到不同的工作进程处理
多进程模式的配置方式
启动Uvicorn时只需要添加--workers参数即可指定工作进程的数量,参数值为大于1的整数时就会启用多进程模式。
命令行启动方式
假设我们的ASGI应用入口文件为main.py,应用实例名为app,需要启动4个工作进程,命令如下:
# 启动4个worker进程的Uvicorn实例 uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4
代码内启动方式
如果需要在Python代码中直接启动多进程的Uvicorn,可以通过Config和Server类配置相关参数:
import uvicorn
from main import app # 导入ASGI应用实例
if __name__ == "__main__":
# 配置Uvicorn参数,指定workers数量为4
config = uvicorn.Config(
app=app,
host="0.0.0.0",
port=8000,
workers=4
)
server = uvicorn.Server(config)
server.run()工作进程数量的选择建议
工作进程的数量并不是越多越好,需要结合服务器的CPU核心数和业务场景合理设置:
- 通常建议将工作进程数设置为服务器CPU核心数的1-2倍,避免进程过多导致上下文切换开销过大
- 如果应用中有大量阻塞IO操作(比如同步的数据库查询、文件读写),可以适当提高进程数,充分利用等待IO的时间
- 如果应用是纯异步逻辑,没有阻塞操作,进程数设置为CPU核心数即可,避免额外的资源浪费
多进程使用的注意事项
使用Uvicorn多进程模式时,需要注意以下几点问题:
1. 应用状态的独立性
每个工作进程都会独立加载ASGI应用,进程之间的内存空间是完全隔离的,因此应用内的全局变量、缓存数据不会在多个进程之间共享。如果有需要共享的状态,需要使用Redis、数据库等外部存储实现。
2. 调试模式不兼容多进程
Uvicorn的--reload调试模式(代码修改后自动重启)和多进程模式不能同时使用,因为主进程无法同时管理热重载和多个工作进程的监听逻辑。开发阶段如果需要调试,建议先使用单进程模式,部署到生产环境再开启多进程。
3. 端口监听的特殊说明
多进程模式下所有工作进程都会监听同一个端口,这是通过操作系统的SO_REUSEPORT选项实现的,不需要手动配置端口分配,Uvicorn会自动处理相关逻辑。如果服务器操作系统不支持该选项,可能会出现端口绑定失败的问题,此时需要升级系统内核或者调整部署方案。
多进程性能验证示例
我们可以通过简单的压测来验证多进程的效果,首先准备一个基础的FastAPI应用:
# main.py
from fastapi import FastAPI
import time
app = FastAPI()
@app.get("/")
async def root():
# 模拟100ms的异步处理耗时
await asyncio.sleep(0.1)
return {"message": "Hello World"}分别启动单进程和4进程的Uvicorn实例,使用wrk工具进行压测,单进程的QPS通常在几十左右,而4进程模式下QPS可以提升到数百,明显体现了多进程并发处理的优势。
注意:压测结果会受服务器配置、网络环境、应用逻辑复杂度的影响,实际数值会有差异,但多进程带来的性能提升是普遍存在的。
常见问题解答
多进程模式下如何优雅关闭所有进程?
向主进程发送SIGTERM信号即可,主进程会先通知所有工作进程停止接收新请求,等待现有请求处理完成后关闭工作进程,最后主进程退出,整个过程不会丢失正在处理的请求。
多进程和异步协程是什么关系?
两者是互补的关系,多进程解决的是CPU核心利用的问题,协程解决的是单进程内IO等待时的并发问题。Uvicorn的多进程每个进程内部仍然可以运行多个协程处理请求,两者结合可以最大化服务器的处理能力。