如何在FastAPI项目中调优Uvicorn工作进程数？-Python教程-PHP中文网

Uvicorn多worker模式并非“越多越快”，盲目设高会因CPU上下文切换剧增、内存线性增长触发OOM、全局锁竞争或下游瓶颈导致性能下降；应基于CPU核心数、可用内存和实际负载合理配置，容器环境优先扩Pod而非进程数。

如何在fastapi项目中调优uvicorn工作进程数？

Uvicorn工作进程数不能盲目设高，设错反而会拖慢响应、触发OOM或让请求排队更久。

为什么`--workers`设多了反而更慢？

每个uvicorn工作进程是独立的Python进程，共享同一份代码但不共享内存。设太多进程会导致：

CPU上下文切换开销剧增，尤其在CPU密集型任务（如语音识别、模型推理）中明显
内存占用线性增长——1G内存服务器上，--workers 4可能直接吃掉800MB+，触发系统OOM Killer杀进程
如果应用本身大量依赖全局锁（比如某些数据库连接池未配置好）、或用了非线程安全的第三方库，多进程反而引发竞争或死锁
对I/O密集型API（如调用外部HTTP接口、读写数据库），提升上限有限；真正瓶颈常在下游服务，而非Uvicorn进程数

`--workers`值怎么算才靠谱？

别套公式硬背，先看真实资源约束：

查CPU核心数：nproc 或 lscpu | grep "CPU(s):"；若为2核，--workers 3（即2×2−1）比--workers 8更稳
查可用内存：用free -h看可用RAM，预留至少300MB给系统和Nginx；假设剩600MB，单worker实测占180MB，则最多跑3个
观察实际负载：启动后用htop看各uvicorn进程CPU%是否持续低于40%，若普遍偏低，说明进程数已过剩
注意容器环境：Kubernetes里通常--workers 1，靠扩Pod数量代替扩进程数；Docker Compose则可设deploy.resources.limits.memory: 512M再配--workers 2

用配置文件管理`--workers`比命令行更可控

命令行启动容易漏参数、难复现，生产环境务必用Python配置文件：

from pydantic import BaseSettings
<p>class UvicornSettings(BaseSettings):
host: str = "0.0.0.0"
port: int = 8000
workers: int = 3  # 显式写死，避免误传
timeout_keep_alive: int = 5
limit_max_requests: int = 10000
log_level: str = "warning"</p><p>settings = UvicornSettings()</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2843" title="Uvicorn 0.52.1"><img
														src="https://img.php.cn/upload/manual/001/221/864/6acee78537d78709.png" alt="Uvicorn 0.52.1" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2843" title="Uvicorn 0.52.1" class="overflowclass">Uvicorn 0.52.1</a>
													<p class="overflowclass">Uvicorn 0.52.1 是 Python ASGI Web 服务器，提供异步应用服务及 WebSocket 支持，常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包，可使用 pip 安装，并由包管理器处理所需依赖。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2843" title="Uvicorn 0.52.1" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>

然后启动：uvicorn main:app --config uvicorn_config.py。这样能确保workers值被版本控制、CI/CD校验，也不会被CI脚本里的$WORKERS环境变量意外覆盖。