如何配置Flask+Gunicorn使Google Cloud Logging显示正确日志级别

问题分析 #

日志能正常显示但级别为空，核心原因是重复的日志初始化逻辑冲突，以及日志级别未正确映射到GCP Severity字段：

• logging_client.setup_logging()会自动添加Cloud Logging Handler，你手动配置的CloudLoggingHandler与之重复，导致级别元数据丢失；
• 自定义格式仅处理了StreamHandler的文本输出，未给Cloud Logging传递结构化的级别标识。

解决方案步骤 #

1. 移除重复初始化

删掉logging_client.setup_logging()这行代码，避免重复添加Handler引发冲突。

2. 改用结构化日志Handler

替换手动配置的CloudLoggingHandler为StructuredLogHandler，它会自动保留日志级别、模块名等结构化元数据，确保GCP日志控制台能正确识别Severity。

3. 明确Flask logger配置

显式指定Flask应用的logger继承root配置，避免日志分流导致级别丢失。

修正后的完整配置代码 #

import logging
from logging.config import dictConfig
from google.cloud import logging as gcp_logging
from flask import Flask

# 初始化GCP日志客户端
logging_client = gcp_logging.Client()

# 配置日志系统
dictConfig(
    {
        "version": 1,
        "formatters": {
            "default": {
                "format": "[%(asctime)s] %(levelname)s in %(module)s: %(message)s",
            }
        },
        "handlers": {
            "wsgi": {
                "class": "logging.StreamHandler",
                "stream": "ext://flask.logging.wsgi_errors_stream",
                "formatter": "default",
            },
            "gcp_structured_logging": {
                "class": "google.cloud.logging.handlers.StructuredLogHandler",
                "client": logging_client,
                "level": "INFO"
            },
        },
        "root": {"level": "INFO", "handlers": ["wsgi", "gcp_structured_logging"]},
        # 显式绑定Flask应用的日志处理器
        "loggers": {
            "flask.app": {
                "level": "INFO",
                "handlers": ["wsgi", "gcp_structured_logging"],
                "propagate": False
            }
        }
    }
)

app = Flask(__name__)

# 测试日志输出
@app.route("/test-log")
def test_log():
    app.logger.critical("Critical级别的测试日志")
    app.logger.error("Error级别的测试日志")
    app.logger.warning("Warning级别的测试日志")
    app.logger.info("Info级别的测试日志")
    return "日志测试完成"

额外优化：Gunicorn日志集成 #

让Gunicorn自身的日志也能正确显示级别到GCP控制台，修改Docker启动命令：

CMD exec gunicorn --bind :$PORT --workers 8 --threads 8 --timeout 0 --log-level=info --access-logfile - --error-logfile - main:app

添加--access-logfile - --error-logfile -将Gunicorn日志重定向到标准输出，自动集成到配置好的日志系统中。

验证方式 #

部署后访问/test-log接口，查看GCP日志控制台：

• 每条日志的Severity字段会对应Flask的日志级别（CRITICAL、ERROR、WARNING、INFO）；
• 可查看结构化日志中的module、asctime等元数据，便于问题排查。

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