仅配置FileHandler的Python logging为何同时输出到文件与标准输出？

问题原因 #

Python的logging模块默认存在日志传播机制：

• 当你创建自定义logger但未关闭传播时，日志会自动向上传递到父级logger（最终到根logger）。
• 根logger在没有被显式配置的情况下，会自动添加一个StreamHandler，负责将日志输出到终端（stdout/err）。
• 哪怕你清空了自定义logger的所有处理器，日志依然会通过传播机制触发根logger的StreamHandler，导致终端输出。

解决方法 #

1. 关闭自定义logger的传播属性 #

这是最直接的解决方案，阻止日志向上传递到根logger：

import logging

# 创建自定义logger
logger = logging.getLogger("my_file_logger")
# 关闭传播，避免日志传到根logger
logger.propagate = False

# 添加FileHandler
file_handler = logging.FileHandler("app.log")
formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
file_handler.setFormatter(formatter)
logger.addHandler(file_handler)
# 设置日志级别（根据需求调整）
logger.setLevel(logging.INFO)

# 测试：此时只会写入文件，不会输出到终端
logger.info("这是一条测试日志")

2. 清理根logger的默认处理器（可选） #

如果你需要彻底移除根logger的默认StreamHandler，避免其他未配置的logger意外输出到终端，可以执行：

# 获取根logger并清空所有处理器
root_logger = logging.getLogger()
root_logger.handlers.clear()

注意：此操作会影响所有依赖根logger的代码，需谨慎使用。

为什么清空自定义logger处理器后仍有终端输出？ #

因为自定义logger的propagate属性默认是True，日志会被传递给根logger。而根logger在未被显式配置时，会自动创建StreamHandler处理日志，所以即使自定义logger没有处理器，日志依然会通过根logger输出到终端。

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