Uvicorn无法通过--workers或--limit-concurrency限制CPU使用率,因前者仅增加进程数、后者仅限并发请求数;真正有效的是容器(--cpus)、systemd(CPUQuota)或cpulimit(按PID限)。

Uvicorn 本身不提供内置的 CPU 使用率限制机制,必须依赖外部系统级工具或运行时约束;直接在 uvicorn 命令里加参数无法实现硬性限频或限核。
为什么不能用 --workers 或 --limit-concurrency 限制 CPU 使用率
这两个参数常被误认为能“压低 CPU 占用”,但实际作用完全不同:
-
--workers只是启动多个进程副本,不控制每个进程的 CPU 时间或核心使用量;反而可能因进程数过多导致上下文切换开销上升、CPU 利用率虚高 -
--limit-concurrency限制的是并发连接/请求数量(即 ASGI 任务队列深度),对 CPU 密集型计算毫无约束力——一个请求里跑while True: pass,照样打满单核 - Uvicorn 的 event loop(如 uvloop)本身高度优化,I/O 场景下 CPU 占用天然很低;真正打满 CPU 的,几乎全是同步阻塞或计算逻辑(
time.sleep、numpy.linalg.svd、PIL 图像处理等)
真正有效的三种落地方式
按适用场景排序,优先选匹配你部署环境的那个:
Uvicorn 0.52.1 是 Python ASGI Web 服务器,提供异步应用服务及 WebSocket 支持,常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理所需依赖。
-
容器环境(Docker):用
--cpus或--cpu-quota。例如限制整个 Uvicorn 容器最多用 1.5 个逻辑核:docker run --cpus=1.5 -p 8000:8000 my-uvicorn-app
注意:该限制对容器内所有进程生效,包括子进程和信号处理线程 -
宿主机长期服务(systemd):用
CPUQuota。编辑 service 文件:[Service] CPUQuota=40%
然后sudo systemctl daemon-reload && sudo systemctl restart myuvicorn.service。这是 cgroups v2 的硬配额,精度高、无信号抖动 -
临时压制失控进程(debug / 紧急):用
cpulimit按 PID 限。先查 PID:pgrep -f "uvicorn.*app:app",再执行:cpulimit -p 12345 -l 30
注意:必须以相同用户或 root 运行;若 Uvicorn 启用了PR_SET_NO_NEW_PRIVS(如某些安全加固镜像),会报Operation not permitted
容易踩的坑:taskset 和 renice 不是 CPU 限速方案
这两个命令在排查时经常被凑合着用,但它们根本达不到“限制使用率”的效果:
-
taskset -c 0只是把进程绑到 CPU 0 上——它仍可在这个核上跑满 100%,和不限制没区别 -
renice -n 19只降低调度优先级——当系统空闲时,该进程依然会吃光全部 CPU 时间,只是“让别人先抢” - 如果你看到 Uvicorn 进程 CPU 占用持续 95%+,且
top显示%CPU接近单核上限(比如 100% 表示占满一个核),那说明它正在做同步计算,此时必须从根源(代码)或资源层(cgroups / Docker)干预,而不是调优先级
最常被忽略的一点:Uvicorn 的 CPU 高占用,90% 以上源于应用代码里的同步操作。与其在外围层层设限,不如先检查有没有 requests.get()、open() 大文件、json.loads() 超长文本这类阻塞调用混在 async 路由里——这才是真正该修复的位置。

















