如何为Flask+Gunicorn部署的应用配置统一格式的日志？

核心思路 #

让Flask应用复用Gunicorn的日志配置（格式、级别），而非独立维护一套日志系统，从根源上解决格式不一致和硬编码级别的问题。

具体实现步骤 #

1. 调整Flask应用日志配置 #

修改Flask代码，禁用其默认日志处理器，直接复用Gunicorn的日志实例：

from flask import Flask
import logging

app = Flask(__name__)

# 清空Flask默认的日志处理器，避免重复输出或格式冲突
app.logger.handlers.clear()

# 获取Gunicorn的错误日志实例（Gunicorn的核心日志都通过这个logger输出）
gunicorn_logger = logging.getLogger("gunicorn.error")

# 将Gunicorn的日志处理器绑定到Flask的logger
app.logger.handlers = gunicorn_logger.handlers

# 同步日志级别：Flask日志级别跟随Gunicorn的配置
app.logger.setLevel(gunicorn_logger.level)

@app.route("/")
def get_json():
    # 测试日志输出，格式和级别将与Gunicorn保持一致
    app.logger.debug("处理GET请求，生成JSON响应")
    app.logger.info("请求处理完成，返回200状态码")
    return {"data": "按需返回的JSON内容"}

2. 统一日志格式（通过Gunicorn配置） #

通过Gunicorn的命令行参数或配置文件定义统一的日志格式，Flask会自动继承该格式。

方式一：命令行启动时指定

gunicorn \
  --workers=3 \
  --bind=0.0.0.0:8000 \
  --log-level=info \  # 全局日志级别，Flask将同步此设置
  --log-format='%(asctime)s [%(process)d] [%(levelname)s] %(message)s' \
  --access-logformat='%(asctime)s [%(process)d] %(remote_addr)s "%(request_line)s" %(status)s' \
  app:app

方式二：使用Gunicorn配置文件

创建gunicorn.conf.py：

workers = 3
bind = "0.0.0.0:8000"
loglevel = "info"
# 错误日志格式（Flask日志将使用此格式）
logformat = "%(asctime)s [%(process)d] [%(levelname)s] %(message)s"
# 访问日志格式（记录HTTP请求）
accesslogformat = "%(asctime)s [%(process)d] %(remote_addr)s \"%(request_line)s\" %(status)s"

启动命令简化为：

gunicorn -c gunicorn.conf.py app:app

3. 关键注意事项 #

• 不要在Flask代码中添加自定义日志处理器，否则会导致日志重复输出。
• Gunicorn的--log-level参数会同时控制自身日志和Flask日志的级别，无需在Flask中硬编码级别（代码中同步级别是为了兼容Gunicorn启动时的动态配置）。
• 如果需要区分Flask日志和Gunicorn日志，可以在日志格式中加入%(name)s字段，Flask日志的name为app，Gunicorn日志的name为gunicorn.error或gunicorn.access。

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