如何修改Quart（Hypercorn）日志的调试级别与格式？多种方法无效

问题背景 #

尝试通过常规第三方日志器配置方法调整Quart的日志级别与格式，包括：

• 调用basicConfig隐式配置根日志器（无论提前或后续执行）
• 通过logging.getLogger("urllib3.connectionpool").setLevel(logging.INFO)方式获取并修改已有日志器

但上述方法对Quart生成的日志器完全无效，日志始终固定输出如下格式：

[2023-07-28 16:17:12 +0200] [1254610] [INFO] Running on http://0.0.0.0:5432 (CTRL + C to quit)

已尝试的无效操作 #

1. 断点确认日志来自hypercorn.error，但直接设置级别无效果：

logging.getLogger("hypercorn.error").setLevel(logging.WARNING)

2. 遵循官方文档使用dictConfig配置：

dictConfig({
    'version': 1,
    'loggers': {
        'quart.app': {'level': 'ERROR'},
        'hypercorn.error': {'level': 'ERROR'},
    },
})

3. 参考相关问题尝试添加自定义处理器并关闭传播：

logger = logging.getLogger("hypercorn.error")
logger.addHandler(my_own_handler)
logger.setLevel(logging.WARNING)
logger.propagate = False

可尝试的解决方向 #

1. 确保日志配置在Quart/hypercorn初始化前执行 #

Hypercorn启动时会初始化自有日志器，若在应用启动后才配置，会被默认配置覆盖。需将dictConfig或日志器配置代码放在app.run()或Hypercorn实例初始化之前，且必须添加disable_existing_loggers: False避免禁用已创建的日志器：

import logging
from logging.config import dictConfig
from quart import Quart

dictConfig({
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'default': {
            'format': '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
        },
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'formatter': 'default',
        },
    },
    'loggers': {
        'quart.app': {
            'handlers': ['console'],
            'level': 'ERROR',
            'propagate': False,
        },
        'hypercorn.error': {
            'handlers': ['console'],
            'level': 'WARNING',
            'propagate': False,
        },
    },
})

app = Quart(__name__)

# 后续路由定义及启动代码

2. 直接通过Hypercorn配置参数修改日志 #

Hypercorn支持通过启动参数直接指定日志配置，无需依赖Python标准logging模块：

from quart import Quart
from hypercorn.config import Config

app = Quart(__name__)

config = Config()
config.log_level = "WARNING"  # 全局日志级别
config.accesslog_format = '%(h)s %(l)s %(u)s %(t)s "%(r)s" %(s)s %(b)s "%(f)s" "%(a)s"'  # 自定义访问日志格式

if __name__ == '__main__':
    app.run(config=config)

也可以指定自定义日志器完全接管Hypercorn的日志输出：

import logging
from quart import Quart
from hypercorn.config import Config

# 创建自定义日志器
custom_logger = logging.getLogger("hypercorn.custom")
custom_logger.setLevel(logging.WARNING)
handler = logging.StreamHandler()
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)
custom_logger.addHandler(handler)
custom_logger.propagate = False

app = Quart(__name__)

config = Config()
config.logger = custom_logger  # 绑定自定义日志器

if __name__ == '__main__':
    app.run(config=config)

3. 排查是否有代码覆盖日志配置 #

检查项目中是否存在其他初始化代码或第三方库重新配置了日志系统，可在关键位置打印日志器状态确认配置是否生效：

logger = logging.getLogger("hypercorn.error")
print(f"当前日志级别: {logger.level}")
print(f"处理器列表: {logger.handlers}")
print(f"是否传播日志: {logger.propagate}")

4. 完全接管Hypercorn日志处理 #

直接将Hypercorn的日志输出绑定到自定义处理器，彻底绕过其默认配置：

import logging
from quart import Quart
from hypercorn.config import Config

handler = logging.StreamHandler()
handler.setFormatter(logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))

app = Quart(__name__)

config = Config()
config.accesslog = handler
config.errorlog = handler
config.log_level = "WARNING"

if __name__ == '__main__':
    app.run(config=config)

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