Jupyter内核中断后Python Logger重复输出及无Handler仍输出问题

问题核心原因 #

Jupyter内核中断后，root logger会被自动添加默认StreamHandler，而自定义的stdout logger因Jupyter的全局状态残留（旧实例未被彻底清理），且propagate=True（默认值），导致日志同时被自定义Handler和root的新Handler处理，最终出现重复输出。

Jupyter的内核重启机制并非完全清空所有全局对象，部分已初始化的logger实例会被保留；而每次启动新会话时，Jupyter会自动初始化root logger的默认输出Handler，两者叠加就引发了重复打印。

根治方案 #

方案1：关闭自定义logger的传播属性 #

在初始化stdout logger时，直接关闭传播，从根源切断日志流向root logger的路径：

import logging

# 初始化自定义logger
stdout = logging.getLogger("stdout")
# 清理可能存在的旧Handler（避免重复添加）
for handler in stdout.handlers[:]:
    stdout.removeHandler(handler)
stdout.addHandler(logging.StreamHandler())
# 关键：关闭传播
stdout.propagate = False

方案2：初始化前清理root logger的默认Handler #

在自定义logger初始化前，先移除root logger的所有Handler，避免重复输出：

import logging

# 清理root logger的所有默认Handler
root_logger = logging.getLogger()
for handler in root_logger.handlers[:]:
    root_logger.removeHandler(handler)

# 再初始化自定义logger
stdout = logging.getLogger("stdout")
stdout.addHandler(logging.StreamHandler())

方案3：强制清空全局状态 #

重启内核后，先执行%reset -f命令清空所有全局变量，再重新初始化logger，彻底清除旧的logger实例残留：

%reset -f
import logging

# 重新初始化logger
stdout = logging.getLogger("stdout")
stdout.addHandler(logging.StreamHandler())

临时解决方法的原理 #

• 设置stdout.propagate=False：阻止自定义logger的日志传播到root logger，仅通过自身Handler输出一次。
• 执行root.removeHandler(root.handlers[0])：移除root logger的默认Handler，即使传播开启，也不会产生额外输出。

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