Gunicorn gevent Worker日志无法输出到stdout问题咨询

嘿，这个问题我之前踩过坑！用gevent worker的Gunicorn跑Django时，日志死活不输出到stdout的情况确实挺让人头疼的，我来分享下当时解决的思路和办法：

核心原因分析 #

其实问题主要出在两个地方：

• Gunicorn的日志处理和Django的logging模块没有正确衔接，gevent的猴子补丁虽然修改了IO行为，但如果日志流没有正确绑定到主线程的stdout，就会“消失”；
• 可能你的Django日志配置没有明确指定输出到stdout，或者Gunicorn没有捕获worker进程的输出。

一步步解决 #

1. 修正Django的日志配置（settings.py） #

确保你的Django日志明确使用指向stdout的StreamHandler，避免gevent环境下流的混淆：

import sys
import os

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'stream': sys.stdout,  # 重点：明确指定输出到sys.stdout
        },
    },
    'root': {
        'handlers': ['console'],
        'level': 'INFO',  # 根据你的需求调整日志级别
    },
    'loggers': {
        # 给Django自身的日志指定handler
        'django': {
            'handlers': ['console'],
            'level': os.getenv('DJANGO_LOG_LEVEL', 'INFO'),
            'propagate': False,
        },
        # 如果你的应用有自定义logger，也要加上
        'your_app_name': {
            'handlers': ['console'],
            'level': 'INFO',
            'propagate': False,
        },
    },
}

2. 调整Gunicorn配置文件（gunicorn.py） #

在你的Gunicorn配置里添加日志相关设置，确保它捕获worker的输出并统一到stdout：

bind = '0.0.0.0:8080'
backlog = 2048
workers = 1
worker_class = 'gevent'
worker_connections = 1000
timeout = 30  # 补全你之前未写完的timeout配置

# 关键日志配置
accesslog = '-'  # 访问日志输出到stdout
errorlog = '-'   # 错误日志输出到stdout
loglevel = 'info'
capture_output = True  # 强制捕获worker进程的stdout/stderr到Gunicorn主日志流

这里的capture_output=True是关键，它会把gevent worker里的所有输出（包括Django的日志）重定向到Gunicorn的主日志流，确保能在终端看到。

3. 额外排查点 #

• 检查你的日志语句是否用对了logger：比如如果用了logging.getLogger(__name__)，要确保这个logger在Django的LOGGING配置里被指定了console handler；
• 启动Gunicorn时不要手动重定向stdout/stderr（比如gunicorn ... > log.txt），那样日志会直接写到文件而不是终端；
• 测试时可以在视图里加一句简单的logging.info("测试日志：请求已处理")，发个请求看看是否输出。

总结 #

本质上就是要让Django的日志明确输出到stdout，同时让Gunicorn把worker的输出统一捕获到主进程的stdout，这样在gevent的协程环境下，日志就能正常显示了。

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