使用2个sync worker运行Gunicorn为何出现大量线程？远超2个线程

Gunicorn的sync worker确实是单进程单线程的设计，每个sync worker进程只会有一个主线程，加上Gunicorn的master进程（默认单线程），正常情况下htop显示的gunicorn相关线程数应该是3个左右。你看到大量线程条目，大概率是以下原因之一：

1. 误配置线程参数或worker类型 #

如果你启动Gunicorn时不小心指定了--threads参数，或者错误选择了线程型worker（比如gthread而非sync），每个worker会生成多个线程。比如--workers 2 --threads 4搭配gthread worker，会生成2*4=8个工作线程，加上master的1个线程，总共9个线程，htop就会显示大量条目。

• 验证方式：查看你的Gunicorn启动命令，确认worker类型是--worker-class sync（或默认，Gunicorn默认worker为sync），且未添加多余的--threads参数。

2. 应用代码创建了额外线程 #

即使使用sync worker，你的Web应用代码也可能在处理请求或初始化阶段创建后台线程：

• 比如用threading模块开启异步任务（如发送邮件、定时处理）、使用依赖线程的第三方库（如某些数据库连接池、异步日志组件）。
• 验证方式：执行ps -efL | grep gunicorn命令，查看每个PID对应的线程数（LWP列为线程ID），找到线程数异常的进程；再通过pstack <PID>（需安装gdb）查看该进程的线程栈，定位线程来源。

3. Gunicorn master进程的额外线程 #

如果你启用了--reload热重载参数，Gunicorn的master进程会启动一个额外的监控线程，用于检测文件变化触发重载，此时master进程会有2个线程。但这种情况只会增加1个线程，不会导致“大量条目”。

4. Python解释器的后台线程 #

少数情况下，Python解释器或运行环境会创建后台线程：

• 比如Python 3.10+的可选后台垃圾回收线程（需手动开启）、某些调试工具或性能监控库（如py-spy、tracemalloc）创建的线程。
• 验证方式：检查是否设置了PYTHON_GC_THRESHOLD等环境变量，或是否启用了相关调试工具。

排查步骤总结 #

1. 执行ps -efL | grep gunicorn，统计每个gunicorn进程的线程数，定位异常进程。
2. 核对Gunicorn启动命令，确认worker类型和参数配置。
3. 对线程数异常的进程执行pstack <PID>，查看线程栈信息，确认线程来源。

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