Python logging模块自定义Filter失效原因及解决方案
在使用Python的logging模块时，自定义Filter有时无法按预期工作，这常常令开发者困惑。本文将通过一个案例分析Filter失效的原因，并提供正确的使用方法。
问题描述：
以下代码片段定义了一个自定义过滤器CustomFilter，旨在仅输出包含“custom”关键字的日志信息。然而，即使设置了logger.setLevel(logging.DEBUG)，也只输出了WARNING、ERROR和CRITICAL级别的日志。
立即学习“Python免费学习笔记（深入）”；
import logging
class CustomFilter(logging.Filter):
def filter(self, record):
message = record.getMessage()
return "custom" in message
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
custom_filter = CustomFilter()
logger.addFilter(custom_filter)
logger.debug("This is a debug message with custom keyword")
logger.info("This is an info message with custom keyword")
logger.warning("This is a warning message with custom keyword")
logger.error("This is an error message with custom keyword")
logger.critical("This is a critical message with custom keyword")
问题分析：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
问题并非Filter本身，而是使用方法错误。logger.setLevel(logging.DEBUG)仅设置了日志记录器的级别，决定了哪些级别的日志信息会被记录。但它并未指定如何输出这些日志信息。
关键在于，代码中缺少Handler 来处理日志信息并将其输出到控制台或文件。logger.addFilter(custom_filter) 只是添加了一个过滤器，它在日志信息传递给Handler之前起作用。没有Handler，即使日志信息被记录，也无法输出，Filter自然无效。
解决方案：
正确的使用方法是先添加一个Handler（例如StreamHandler，将日志输出到标准输出流），然后再添加Filter：
import logging
class CustomFilter(logging.Filter):
def filter(self, record):
message = record.getMessage()
return "custom" in message
logger = logging.getLogger(__name__)
handler = logging.StreamHandler() # 添加Handler
logger.addHandler(handler)
logger.setLevel(logging.DEBUG)
custom_filter = CustomFilter()
logger.addFilter(custom_filter)
logger.debug("This is a debug message with custom keyword")
logger.info("This is an info message with custom keyword")
logger.warning("This is a warning message with custom keyword")
logger.error("This is an error message with custom keyword")
logger.critical("This is a critical message with custom keyword")
通过添加Handler，日志信息才能被正确处理和输出，Filter才能生效，实现预期的日志过滤功能。只有日志信息传递给Handler后，Filter才能对其进行过滤。
通过以上修改，只有包含“custom”关键字的日志信息才会被输出，其他级别的日志信息将被Filter过滤掉。 记住，Handler是logging模块中不可或缺的部分，它负责将日志信息输出到目标位置。
