Python中无法向io.StringIO流写入日志的问题排查

核心问题：日志级别的双层过滤机制 #

你遇到的流为空问题，根源在于logging模块的日志过滤是「先过logger自身级别，再过handler级别」。

默认情况下，logger的级别是logging.WARNING，哪怕你给handler设置了INFO级别，只要logger的级别高于INFO，logger.info()的日志会被logger直接过滤掉，根本传不到handler里，所以你的StringIO流自然是空的。

而换成logger.warning()能正常工作，是因为warning级别刚好匹配logger的默认级别，能通过logger的过滤，最终被handler写入流中。

额外问题：日志打印到控制台 #

这是因为Python的logging模块默认会给root logger添加一个输出到控制台的StreamHandler。如果不想日志打印到控制台，需要手动阻止日志向上传递：

import logging, io

# 初始化StringIO流
stream = io.StringIO()

# 获取logger并配置核心参数
logger = logging.getLogger(__name__)
logger.setLevel(logging.INFO)  # 关键：把logger级别设为INFO或更低，让info日志能通过
logger.propagate = False  # 阻止日志传递给root logger，避免控制台输出

# 配置handler
log_handler = logging.StreamHandler(stream)
log_format = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
log_handler.setFormatter(log_format)
log_handler.setLevel(logging.INFO)

logger.addHandler(log_handler)

logger.info("This is test info log")
print(stream.getvalue())

关键修正点总结 #

• 必须给logger设置级别（比如logging.INFO），且级别要≤你要输出的日志级别
• 设置logger.propagate = False，阻止日志向上传递到root logger的默认控制台handler

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