必须安装 fastapi[standard],否则无法启用 uvloop 和 httptools,QPS 损失 30%~50%;Python 应锁定 3.11.9 或 3.12.4;Uvicorn worker 数建议设为 CPU 核心数×1~1.5,并启用 --limit-concurrency 和 --ws-per-message-deflate;async 函数中严禁同步阻塞调用。

fastapi[standard]必须装,否则连性能优化的门槛都跨不过去
FastAPI 本身不带服务器,也不自带高性能解析器。只执行 pip install fastapi,你得到的是一个“没轮子的车”——启动靠手动配 uvicorn,HTTP 解析用默认的 h11(慢),事件循环还是标准 asyncio(没加速)。实测在 Python 3.11 下,pip install "fastapi[standard]" 能直接带来 30%~50% 的 QPS 提升,核心就是它顺手装了 uvicorn[standard],进而启用 uvloop(Linux/macOS)和 httptools。
验证是否生效很简单:启动服务后看控制台日志,出现 Using uvloop 或 Using httptools 就说明加载成功。Windows 用户不用强求 uvloop(它不支持),但 httptools 依然生效;如果看到异常提示或启动卡顿,可以加 --http h11 显式降级,避免误判为配置失败。
Python 3.11 版本要锁死小版本,别贪新
CPython 3.11.9 是当前最稳的选择。3.11 引入了细粒度锁优化和更快的类型检查路径,对 pydantic(FastAPI 的数据校验核心)解析速度提升明显;3.12.4 也不错,异步调度响应性更好。但 3.13 尚未被 uvicorn、asyncpg 等主流驱动完全适配,上线前踩坑成本高。
虚拟环境必须基于目标版本创建:python3.11 -m venv venv,而不是靠 requirements.txt 里写 python>=3.11 —— 那只约束依赖,不约束解释器本身。CI/CD 或容器部署时,应通过镜像固化(如 python:3.11.9-slim)或 pyenv 锁定运行时,避免开发机和生产机行为不一致。
Uvicorn worker 数不是越多越好,4 核机器通常设 -w 4
Uvicorn 是单线程异步模型,每个 worker 独占一个事件循环。盲目增加 -w(比如设成 16)会导致 CPU 上下文切换激增、内存冗余、甚至文件描述符耗尽。推荐值是 CPU 核心数 × 1~1.5,4 核机器设 -w 4 或 -w 6 就够用。
Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期,并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能
- 必须加
--limit-concurrency 100:防止单个 worker 接收过多连接压垮内存 - 禁用
--reload:生产环境开启会导致多进程间连接状态不同步,WebSocket 尤其危险 - 启用
--ws-per-message-deflate:对文本类 WebSocket 消息可减小 40%+ 传输体积
async def 里混同步调用 = 自毁式并发
这是最常被忽略的性能杀手。写了个 async def,里面却调 time.sleep(5)、requests.get()、json.loads(big_str) 或未 await 的 psycopg2 查询 —— 这些操作会卡死整个事件循环,所有并发请求排队等它结束。
正确做法分三类:
- IO 密集型:换异步库,
httpx.AsyncClient替requests,asyncpg替psycopg2 - CPU 密集型:丢进线程池,
await asyncio.to_thread(json.loads, data) - Pydantic 校验:高频场景下关掉自动验证,或用
model_validate_json()避免重复解析
真正的并发瓶颈往往不在框架,而在你有没有把阻塞点从事件循环里摘出来。哪怕只漏掉一个 time.sleep,整台机器的并发能力就退化回同步模型。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










