如何在Gunicorn中捕获Python原生logging模块的日志？

你的核心问题是：Flask的app.logger能正常写入Gunicorn的error.log，但项目中脱离应用上下文的代码（比如外部工具函数、单元测试）使用Python原生logging模块输出的日志只会打到stdout，无法统一到同一个日志文件。可以通过以下两种方式解决：

方案一：全局复用Gunicorn日志配置（推荐） #

利用Python logging的层级继承特性，将根logger的配置与Gunicorn的error logger对齐，这样所有自定义的logging.getLogger(__name__)都会自动继承根logger的handler和日志级别，无需逐个模块修改。

修改你的app.py代码：

import logging
from flask import Flask, jsonify

app = Flask(__name__)

@app.route("/")
def index():
     app.logger.info("index hit")
     return jsonify("ok")

if __name__ != "__main__":
    # 获取Gunicorn的error日志实例
    gunicorn_logger = logging.getLogger("gunicorn.error")
    
    # 配置Flask内置logger
    app.logger.handlers = gunicorn_logger.handlers
    app.logger.setLevel(gunicorn_logger.level)
    
    # 配置根logger，让所有原生logging的日志都走Gunicorn的handler
    root_logger = logging.getLogger()
    root_logger.handlers = gunicorn_logger.handlers
    root_logger.setLevel(gunicorn_logger.level)
    
    app.logger.info("已为Flask和全局日志启用Gunicorn日志配置")

方案二：针对特定模块单独配置 #

如果不想修改全局根logger的配置，可以单独给外部模块的logger绑定Gunicorn的handler：

方式1：在app启动时配置 #

在app.py的Gunicorn初始化块中添加：

if __name__ != "__main__":
    gunicorn_logger = logging.getLogger("gunicorn.error")
    
    # 配置Flask logger（原有代码保留）
    app.logger.handlers = gunicorn_logger.handlers
    app.logger.setLevel(gunicorn_logger.level)
    
    # 给外部模块的logger配置Gunicorn handler
    external_module_logger = logging.getLogger("your_external_module")  # 替换为实际模块名
    external_module_logger.handlers = gunicorn_logger.handlers
    external_module_logger.setLevel(gunicorn_logger.level)

方式2：在外部模块内部配置 #

在你的外部函数文件中添加日志初始化逻辑：

import logging

logger = logging.getLogger(__name__)

def setup_logging():
    # 仅在Gunicorn环境下生效
    gunicorn_logger = logging.getLogger("gunicorn.error")
    if gunicorn_logger.handlers:
        logger.handlers = gunicorn_logger.handlers
        logger.setLevel(gunicorn_logger.level)

# 模块加载时自动初始化日志配置
setup_logging()

def my_external_function(*args):
   logger.info("My function has been called")
   # 业务逻辑

验证效果 #

保持原有的Gunicorn启动命令不变：

gunicorn app:app -b 0.0.0.0:8080 \
    --access-logfile /var/log/myapp/access.log \
    --error-logfile /var/log/myapp/error.log \
    --log-level INFO

此时，无论是app.logger输出的日志，还是外部函数中logger.info的日志，都会统一写入/var/log/myapp/error.log，不再输出到stdout。

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