如何为自定义Python logger设置日志级别并解决重复输出问题

核心问题原因 #

1. 仅输出WARNING及以上级别日志的原因：
   Python logging模块采用两级过滤机制：日志先匹配Logger本身的级别，再匹配Handler的级别。Logger默认级别为logging.WARNING，即使Handler设置了DEBUG级别，低于WARNING的日志也会被Logger直接拦截，无法传递到Handler。
2. 取消logging.basicConfig注释后日志重复的原因：
   logging.basicConfig会自动为根Logger创建默认的StreamHandler，而子Logger默认开启propagate属性，会将日志向上传递给父Logger的Handler处理，相当于自定义Handler和根Logger的默认Handler各输出一次，导致重复。

正确配置代码 #

修改后的logger.py如下：

# logger.py
import logging

logger = logging.getLogger(__name__)
# 显式设置Logger本身的最低处理级别
logger.setLevel(logging.DEBUG)
# 关闭日志向上传播，避免触发根Logger的默认Handler输出
logger.propagate = False

c_handler = logging.StreamHandler()
c_handler.setLevel(logging.DEBUG)

c_format = logging.Formatter('%(name)s - %(levelname)s - %(message)s')
c_handler.setFormatter(c_format)

logger.addHandler(c_handler)

配置说明 #

• 无需保留logging.basicConfig相关代码，上述配置即可正常输出DEBUG及以上级别的日志
• 若需要调整全局日志过滤级别，修改logger.setLevel()的参数即可，Handler的级别可以单独设置做二次过滤

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