如何配置Python日志：确保所有日志写入文件不受setLevel影响

问题分析 #

你遇到的核心问题是：logging模块的日志过滤是先经过Logger级别过滤，再传递给各个Handler。当你在main.py中调用logger.setLevel(logging.WARNING)时，Logger本身会过滤掉所有低于WARNING级别的日志（比如INFO），导致这些日志根本无法到达文件Handler，自然无法写入文件。

要实现「控制台显示级别可由用户控制，但所有日志必须写入文件」的需求，需要让Logger始终放行所有级别的日志，同时让用户的setLevel操作仅作用于控制台Handler，而非Logger本身。

解决方案 #

修改日志初始化代码，固定Logger的级别为最低级（DEBUG），并自定义setLevel方法，让用户调用时仅修改控制台Handler的级别：

修改后的initialize_logging.py #

import logging

def initialize_logging():
    logger = logging.getLogger('attribution')
    # 固定Logger级别为DEBUG，确保所有级别的日志都能传递到Handler
    logger.setLevel(logging.DEBUG)
    
    # 避免重复添加Handler（多次导入模块时防止日志重复写入）
    if logger.handlers:
        return logger

    formatter = logging.Formatter('%(asctime)s - %(levelname)s: %(message)s')

    # 文件Handler：始终记录所有级别日志
    fh = logging.FileHandler('./files/logs/attribution.log')
    fh.setLevel(logging.DEBUG)
    fh.setFormatter(formatter)
    logger.addHandler(fh)

    # 控制台Handler：初始级别为WARNING，后续由用户控制
    ch = logging.StreamHandler()
    ch.setLevel(logging.WARNING)
    ch.setFormatter(formatter)
    logger.addHandler(ch)

    # 自定义setLevel方法，让用户调用时仅修改控制台Handler的级别
    def custom_set_level(level):
        for handler in logger.handlers:
            if isinstance(handler, logging.StreamHandler):
                handler.setLevel(level)

    logger.setLevel = custom_set_level
    return logger

# 模块导入时自动完成初始化
logger = initialize_logging()

测试用main.py #

%load_ext autotime
import initialize_logging
import logging

logger = logging.getLogger('attribution')
# 设置控制台仅显示WARNING及以上级别日志
logger.setLevel(logging.WARNING)

# INFO级日志：仅写入文件，不显示在控制台
logger.info('TEST INFO')
# WARNING级日志：既写入文件，也显示在控制台
logger.warning('TEST WARNING')
# DEBUG级日志：仅写入文件，不显示在控制台
logger.debug('TEST DEBUG')

关键逻辑说明 #

1. 固定Logger级别：将Logger的级别设为DEBUG，确保所有级别的日志都能通过Logger的第一道过滤，传递给各个Handler。
2. 自定义setLevel方法：覆盖Logger原本的setLevel，让用户调用该方法时，仅遍历修改所有StreamHandler（控制台输出）的级别，而Logger自身级别保持不变。
3. 文件Handler配置：文件Handler的级别设为DEBUG，确保所有传递过来的日志都会被写入文件。
4. 重复Handler防护：添加if logger.handlers:判断，避免多次导入模块时重复添加Handler，导致日志重复写入。

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