Python logging YAML配置：全局日志级别未生效问题排查

1. 用空字符串键定义全局日志器的方式不可行 #

Python logging模块中，空字符串对应的是一个名为空字符串的独立日志器，并不是所有模块日志器的默认父级。模块通过logging.getLogger(__name__)创建的日志器，默认父级是根日志器（root），而非空字符串日志器，所以这种配置方式无法作用于所有模块日志器。

2. 正确的配置方式 #

要实现给所有logging.getLogger(__name__)的模块统一设置日志级别，需要直接配置根日志器（root），而非空字符串键的日志器。具体调整如下：

修正后的YAML配置示例 #

version: 1
formatters:
  default:
    format: '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
handlers:
  console:
    class: logging.StreamHandler
    formatter: default
root:
  level: WARNING
  handlers: [console]
# 若需单独配置命名日志器（如my_logger），可保留以下配置
loggers:
  my_logger:
    level: WARNING
    propagate: True

关键说明 #

• 模块通过logging.getLogger(__name__)创建的日志器，默认会继承根日志器的级别，且propagate默认值为True，会自动将日志传递给父级（即root）的处理器输出，无需额外配置propagate。
• 如果代码中存在模块显式调用logger.setLevel(...)的情况，会覆盖继承的根日志器级别，需要检查并移除这类代码才能让全局配置生效。

内容的提问来源于stack exchange，提问作者Leen De Silva