gunicorn -k gevent并发未提升,主因是monkey.patch_all()未置于app.py或wsgi.py首行,导致socket等模块未被协程化而静默退化为同步;必须配合--worker-connections、数据库连接池扩容及日志验证using gevent字样。

gunicorn -k gevent 启动后并发没提升,基本是 monkey.patch_all() 没生效
加了 --worker-class gevent 却看不出并发能力变化,90% 的情况是 gevent.monkey.patch_all() 没起作用——它必须出现在应用入口文件(如 app.py 或 wsgi.py)的**第一行**,早于所有可能触发 I/O 的 import,包括 from flask import Flask、import requests、from sqlalchemy import create_engine 等。
一旦某个模块(比如 psycopg2、urllib3 或 Flask-SQLAlchemy)在 patch 前完成初始化,它内部用的仍是原生阻塞 socket,整个协程栈就静默退化为同步模型。
- 检查日志里是否出现
using gevent;若只有Booting worker with pid且无 gevent 字样,说明 worker class 没真正加载 - 确认
pip install gevent gunicorn在当前运行环境中已执行,虚拟环境要激活后再装 - 若用 PostgreSQL,额外加
gevent.monkey.patch_psycopg();MySQL 用户注意pymysql需monkey.patch_socket()
--worker-connections 不设等于白配 gevent
--worker-connections 是 gevent worker 的实际并发上限,不是可选项。不显式指定时虽有默认值 1000,但这个值只有在 monkey.patch_all() 成功后才真正生效;否则 gevent 退化为 sync 模式,该参数形同虚设。
它和 --workers 共同决定理论最大并发数:总协程数 = --workers × --worker-connections。但真实吞吐受数据库连接池、外部 API 限流等制约,不能只堆数值。
立即学习“Python免费学习笔记(深入)”;
- 内存紧张(如 1GB RAM)时,建议设为
256或512,避免 OOM - 搭配
--workers 4时,--worker-connections 2000比默认 1000 更适配突发流量 - 压测中若 CPU 很低但大量请求超时,大概率是 patch 失败或未 patch 的库(如某些 C 扩展)导致协程卡死
数据库连接池不匹配,gevent 就是空转
gevent 让 Python 层并发上去了,但如果数据库连接没池化,所有协程还是会抢同一个连接,变成串行等待。Django/Flask 默认的 CONN_MAX_AGE=0 或 SQLALCHEMY_POOL_SIZE=5 完全不适合 gevent 场景。
连接池大小必须 ≥ --workers × --worker-connections,否则请求会在 DB 层排队,QPS 上不去,日志里满是 timeout 和 connection pool exhausted。
- Flask-SQLAlchemy:设
SQLALCHEMY_POOL_SIZE和SQLALCHEMY_MAX_OVERFLOW总和 ≥ 单机总协程数 - Django:设
CONN_MAX_AGE > 0(如 60),并调大MAX_CONNS(需 psycopg2cffi 或 patch 后支持) - 避免在请求路径中手动
engine.dispose()或频繁create_engine(),会绕过连接池
哪些代码会让 gevent 静默失效
gevent 只能调度被 patch 过的 I/O 操作。以下代码一旦出现在请求处理路径中,就会让当前 worker 完全阻塞,失去并发能力:
- 原生
time.sleep(1)→ 改用gevent.sleep(1) - 未 patch 的
requests.get()→ 要么装gevent-requests,要么确保monkey.patch_all(ssl=True)已执行 - 直接调用
subprocess.Popen()→ 它不走 socket,patch 不到;应换gevent.subprocess或移至ProcessPoolExecutor - 用了
threading.Thread或concurrent.futures.ThreadPoolExecutor→ 协程无法调度线程,整个 worker 被锁住
这些陷阱不会报错,只会让并发能力断崖式下跌,排查时得盯着 CPU 使用率和请求延迟曲线交叉验证——低 CPU + 高延迟 = 协程被阻塞的典型信号。


















