Django用gunicorn多worker和gevent提升并发

本文深入解析了如何通过合理配置 Gunicorn 的多 Worker 进程与 gevent 协程机制，显著提升 Django 应用的并发处理能力：默认单 Worker 无法利用多核 CPU，需显式设置 `-w` 参数并启用 `--preload` 避免重复初始化和连接泄漏；gevent 能在 IO 密集型场景下以少量 Worker 支撑高并发，但必须前置 `monkey.patch_all()` 且禁用线程、配好数据库连接池（`CONN_MAX_AGE=0`），而 CPU 密集型任务仍应依赖多进程；同时强调关键配置如 `--timeout`、`--keep-alive` 和 `--max-requests` 对稳定性和性能的决定性影响——不调这三项，再多 Worker 也难逃超时、连接耗尽或内存泄漏。

gunicorn 启动 Django 时为什么没用上多核

默认 gunicorn 只开 1 个 worker，哪怕你机器有 8 核，也只压着一个 CPU 跑。Django 本身是同步阻塞的，不靠多进程（或协程）根本没法吃满 CPU。

实操建议：

• 显式指定 -w 参数，比如 -w 4 开 4 个 worker 进程（一般设为 CPU 核数 × 2，但别盲目堆高——每个 worker 都吃内存）
• 确认 --preload 是否开启：不开的话，每个 worker 会单独导入 Django，可能触发重复初始化、DB 连接泄漏；开了则主进程先加载再 fork，更安全
• 避免用 --threads 混合多线程：Django 的 ORM 和中间件大多非线程安全，线程数 >1 容易出 DatabaseError: database is locked 或状态错乱

gevent 协程真能提升并发？什么场景下反而拖后腿

gevent 把阻塞调用（如 HTTP 请求、DB 查询、文件读写）自动转成协程让出控制权，单个 worker 就能并发处理几百连接——但前提是这些 IO 真的被 gevent patch 住了。

实操建议：

• 必须在最开头（manage.py 或 gunicorn.conf.py 顶部）加 from gevent import monkey; monkey.patch_all()，漏掉 patch_ssl=True 会导致 HTTPS 请求卡死
• Django 的 runserver 不支持 gevent，必须用 gunicorn --worker-class=gevent --workers=2 --worker-connections=1000 启动
• 如果代码里有大量 CPU 密集操作（比如 Pandas 计算、图像处理），gevent 无济于事，反而因协程调度增加开销；这时老老实实用多进程 + -w 更稳

worker 类型选 sync / gevent / eventlet？看日志和错误再决定

不是越“高级”的 worker 类型越好。sync 最简单可靠，gevent 性能高但依赖 patch，eventlet 类似但社区维护弱、Python 3.11+ 兼容性差。

常见错误现象：

• ImportError: No module named 'gevent.monkey' → 忘装 gevent 或没 import monkey
• BlockingIOError: [Errno 11] Resource temporarily unavailable → worker-connections 设太高，超出系统文件描述符限制（用 ulimit -n 查，需同步调大）
• HTTP 请求超时、部分请求直接 502 → gevent 下 DB 连接池没配好，CONN_MAX_AGE=0 是必须的，否则连接在协程间复用出错

配置里最容易被忽略的三个硬指标

并发能力不只看 worker 数，这三个参数不调，再多进程也白搭。

• --timeout 30：默认 30 秒，长耗时接口（如导出）会直接被 kill，按业务设高，但别设成 0（禁用超时）
• --keep-alive 5：HTTP Keep-Alive 保持时间，太短导致频繁建连，太长占着 worker 不放人，5–10 秒较平衡
• --max-requests 1000：强制 worker 重启，防内存泄漏（尤其用了 C 扩展或全局缓存时），不设可能跑几天后 OOM

真实线上环境里，--worker-class=gevent 和 --max-requests 组合用得最多——协程省资源，定期重启兜底。

到这里，我们也就讲完了《Django用gunicorn多worker和gevent提升并发》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！