Python日志过滤器仅添加到StreamHandler，为何作用于所有Handler？

核心原因 #

你大概率是在过滤器里直接修改了日志记录对象（LogRecord）的属性，而Python日志系统中，同一个LogRecord会被传递给所有注册的Handler。一旦你在StreamHandler的过滤器里修改了它的levelname（比如加上颜色控制代码），后续的FileHandler拿到的就是已经被修改过的LogRecord，自然会把颜色代码写入文件。

正确的解决思路 #

日志模块的职责划分很明确：过滤器负责筛选哪些日志要被处理，格式化器负责定义日志内容的格式，处理器负责输出到指定目标。给终端日志加颜色应该用自定义Formatter，而不是过滤器，并且给StreamHandler和FileHandler分别配置不同的Formatter，避免互相干扰。

示例代码 #

import logging

# 定义两种格式：终端带颜色、文件无颜色
TERMINAL_FORMAT = "%(asctime)s - %(levelname)s - %(message)s"
FILE_FORMAT = "%(asctime)s - %(levelname)s - %(message)s"

# 日志级别对应的颜色控制码
LEVEL_COLOR_MAP = {
    logging.DEBUG: "\033[94mDEBUG\033[0m",
    logging.INFO: "\033[92mINFO\033[0m",
    logging.WARNING: "\033[93mWARNING\033[0m",
    logging.ERROR: "\033[91mERROR\033[0m",
    logging.CRITICAL: "\033[95mCRITICAL\033[0m"
}

# 自定义带颜色的格式化器
class ColorFormatter(logging.Formatter):
    def format(self, record):
        # 复制LogRecord对象，避免修改原始记录影响其他处理器
        record_copy = logging.LogRecord(
            record.name, record.levelno, record.pathname, record.lineno,
            record.msg, record.args, record.exc_info, record.funcName, record.stack_info
        )
        # 替换副本的levelname为带颜色的版本
        record_copy.levelname = LEVEL_COLOR_MAP.get(record.levelno, record.levelname)
        return super().format(record_copy)

# 配置日志
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
logger.handlers.clear()  # 避免重复添加处理器

# 终端处理器：使用带颜色的格式化器
stream_handler = logging.StreamHandler()
stream_handler.setFormatter(ColorFormatter(TERMINAL_FORMAT))
logger.addHandler(stream_handler)

# 文件处理器：使用普通格式化器
file_handler = logging.FileHandler("app.log")
file_handler.setFormatter(logging.Formatter(FILE_FORMAT))
logger.addHandler(file_handler)

# 测试日志输出
logger.debug("这是调试信息")
logger.info("这是普通信息")
logger.warning("这是警告信息")
logger.error("这是错误信息")
logger.critical("这是严重错误信息")

关键说明 #

通过复制LogRecord对象，我们只修改了终端处理器要用的副本，原始记录保持不变，这样FileHandler拿到的还是纯净的日志内容，不会混入颜色控制代码。

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