Django+Gunicorn+Gevent部署遇MonkeyPatchWarning问题求助

问题根源 #

你遇到的警告本质是补丁时机不对和重复补丁的问题，和你当前使用的--preload参数直接相关：

• 当启用--preload时，Gunicorn主进程会先完整加载Django应用，再fork worker进程。你把monkey.patch_all()写在wsgi.py开头，主进程加载wsgi时会执行一次补丁，worker进程启动时又会重复执行，这就触发了多次补丁的警告。
• 主进程加载Django应用的过程中，很多第三方依赖（比如requests、DRF这类常用库）会在补丁执行前就间接导入urllib3，而urllib3内部会自动加载ssl模块——等你的补丁执行时，ssl已经被导入了，自然会弹出"ssl已导入后补丁"的警告。

可行解决方案 #

1. 直接移除--preload（最简单） #

如果服务器内存足够，直接删掉启动命令里的--preload参数即可。此时每个worker进程会独立加载应用并执行补丁，不会出现主进程提前加载依赖的问题。启动命令改成：

gunicorn --worker-class gevent myapp.wsgi:application

缺点是多个worker会重复加载应用，内存占用会高一些，但胜在简单，适合中小规模部署。

2. 把补丁移到Gunicorn启动前执行（保留--preload） #

要既保留--preload的内存优势，又解决补丁时机问题，最好的办法是让补丁在Gunicorn加载任何应用代码前就执行：

1. 在项目根目录新建一个bootstrap.py文件：

from gevent import monkey
# 显式指定patch ssl，确保覆盖所有模块
monkey.patch_all(ssl=True)
# 导入并启动Gunicorn
import gunicorn.main
gunicorn.main.main()

2. 修改Docker-Compose里的启动命令，用这个脚本启动Gunicorn：

python bootstrap.py --preload --worker-class gevent myapp.wsgi:application

这样补丁会在Gunicorn碰任何Django代码或第三方依赖前就完成，彻底避免ssl/urllib3提前导入的问题；同时主进程只执行一次补丁，worker进程fork后直接继承已补丁的环境，不会出现重复补丁的警告。

3. 给wsgi.py的补丁加判断（折中方案） #

如果硬要在wsgi.py里放补丁，可以通过判断进程是否为worker来避免重复执行：

import os
from gevent import monkey

# 仅在Gunicorn主进程执行补丁（worker进程的启动参数里会包含--worker）
if "--worker" not in os.environ.get("ARGV", ""):
    monkey.patch_all(ssl=True)

# 之后再导入Django相关代码
import django
from django.core.wsgi import get_wsgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myapp.settings')
django.setup()
application = get_wsgi_application()

这种方法依赖环境变量，不如方案2可靠，因为Gunicorn的参数传递逻辑可能变化，适合临时应急用。

额外提醒 #

• 确保你的IO密集型操作都用了支持gevent的库，比如用requests时，要确认它依赖的urllib3已经被正确补丁（方案2能保证这一点）。
• 别在Django的settings.py或其他会被提前加载的模块里导入ssl、urllib3相关代码，不然哪怕补丁在ws.py开头，也可能触发提前导入。

内容的提问来源于stack exchange，提问作者MikeSchem