采用gevent工作类的Gunicorn中Flask应用Python日志不显示问题咨询

安全阿岳

2026-11-1

问题解决步骤

你遇到的这个问题是gevent + flask-executor + 日志链路的经典踩坑点，完全不需要更换worker类型，按顺序排查就能解决：

核心根因是流对象句柄绑定错位
gevent worker的启动流程有个容易忽略的细节：进程会先初始化gunicorn自身的日志系统，把日志处理器绑定到原始的stderr文件句柄，之后才执行gevent猴子补丁，把sys.stdout/sys.stderr替换成gevent包装的非阻塞流对象，最后才会加载你的Flask应用代码。
你在应用初始化阶段手动创建的StreamHandler，默认绑定的是猴子补丁替换后的新stderr对象；而后面手动挂载的gunicorn日志处理器本身是绑在旧的原始句柄上的。在gevent非阻塞IO模型下，新stderr流的写入操作会被暂时缓存到gevent的事件循环缓冲区，没有主动触发刷新的话，这些缓存的自定义日志永远不会落到磁盘文件里。
这也完全匹配你观察到的现象：
- 切回sync worker正常：sync worker没有猴子补丁替换流对象的过程，你初始化的StreamHandler绑定的就是最终写盘的同一个stderr句柄，写完直接落盘
- 第三方库日志正常：第三方库基本都是在长任务运行时才完成初始化，拿到的stderr引用是经过完整monkey patch、和gunicorn日志写入链路打通的对象，自然能正常写盘
第一步修正猴子补丁加载顺序
不要依赖gunicorn自动的gevent worker补丁流程，直接在src/__init__.py的最顶部，也就是所有import语句的最前面手动加载补丁：
```
from gevent import monkey
monkey.patch_all()
```
gunicorn自动打补丁的时机是固定的，如果你在补丁加载之前就import了logging、threading这些模块，模块内部持有的流引用、线程类是不会被补丁替换的，必然出现流对象不一致的问题。手动在代码最开头打补丁，能从根源上统一所有模块持有的thread、IO流引用，和gunicorn的补丁流程完全对齐。

第二步修正日志处理器的挂载逻辑
去掉你之前手动创建独立StreamHandler、调用logging.basicConfig的冗余配置，避免出现双份句柄绑定的问题，把非__main__运行分支的日志配置改成：

if __name__ != '__main__':
    gunicorn_error_logger = logging.getLogger('gunicorn.error')
    # 应用日志级别和gunicorn完全对齐
    app.logger.setLevel(gunicorn_error_logger.level)
    # 直接复用gunicorn的handler，不手动新建流对象
    app.logger.handlers = gunicorn_error_logger.handlers
    # 你在src包下定义的根logger
    your_src_root_logger = logging.getLogger('src')
    your_src_root_logger.setLevel(gunicorn_error_logger.level)
    your_src_root_logger.handlers = gunicorn_error_logger.handlers
    # 关闭向上传播，避免日志往root logger重复传递导致丢失或重复
    your_src_root_logger.propagate = False

第三步修正gunicorn启动命令
你现在的启动命令写法有冗余，混乱的重定向逻辑在部分shell环境下会导致gunicorn的日志句柄错配，精简成标准写法：
```
nohup gunicorn -w 1 src:app -b 127.0.0.1:5000 --worker-class gevent --log-level info > ./gunicorn_log.out 2>&1 &
```
原命令里放在&后面的> /dev/null 2> /dev/null是绑定到当前shell的，不属于gunicorn进程，但是这种分散的重定向写法很容易出现边界问题，删掉就好。
快速验证方法
你可以在之前打不出来日志的logger.info()调用后面，手动加一行sys.stderr.flush()，如果之前丢失的日志全部一次性输出，就100%确认是流句柄缓存错位的问题。

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