Python 3.12.9中QueueListener是否破坏FileHandler的setLevel设置？

这不是操作错误，而是QueueListener的设计特性——它默认会跳过绑定Handler的级别校验，直接将队列中的日志记录传递给Handler执行输出。

具体原因 #

当你使用QueueHandler时，日志记录会先经过Logger的级别过滤（这里root_logger设为DEBUG，所以INFO和WARNING都会进入队列）。而QueueListener在取出队列中的LogRecord后，不会调用Handler的filter()方法或检查其level属性，直接调用Handler的emit()方法写入日志，导致FileHandler的setLevel(logging.WARNING)设置失效。

修复方法 #

有两种可行的修复方式：

• 在Logger层面过滤级别：调整root_logger或目标Logger的级别为WARNING，这样低于WARNING的日志根本不会进入队列。

  # 方式1：修改root_logger级别
  root_logger.setLevel(logging.WARNING)
  # 或者方式2：修改TestLogger级别
  logger = logging.getLogger("TestLogger")
  logger.setLevel(logging.WARNING)
  

• 给QueueListener添加级别过滤：自定义一个带级别检查的QueueListener子类，在处理记录前先校验Handler的级别：

  class LevelCheckingQueueListener(logging.handlers.QueueListener):
      def handle(self, record):
          # 检查每个绑定Handler的级别是否允许该记录
          for handler in self.handlers:
              if handler.level <= record.levelno:
                  handler.handle(record)
  
  # 使用自定义子类替代原QueueListener
  queue_listener = LevelCheckingQueueListener(log_queue, file_logger)
  

验证效果 #

使用上述任意一种方法后，运行代码只有WARNING级别的日志会写入Test.log文件，INFO日志会被正确过滤。

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