如何防止Python导入包/模块添加logging handlers导致重复日志

核心目标是在所有第三方依赖加载前就植入全局拦截逻辑，从根源阻止非root logger绑定Handler，无需事后反复清理。

方案1：猴子补丁拦截addHandler调用（推荐，性能最优） #

该方案直接重写Logger类的addHandler方法，仅允许root logger添加处理器，其余所有logger的加handler操作直接拦截，一劳永逸。
必须将这段代码放在项目所有导入语句的最前端执行，确保在任何违规添加handler的第三方包加载前完成补丁

import logging

# 留存原始addHandler方法引用
_original_add_handler = logging.Logger.addHandler

def _restricted_add_handler(self, handler):
    # 非root logger调用addHandler时直接拦截，可选加debug日志留痕
    if self is not logging.root:
        # 排查问题时可打开下面这行日志，记录是哪个logger尝试私加handler
        # logging.root.debug(f"Blocked unauthorized handler on logger: {self.name}")
        return
    # root logger正常执行原始逻辑
    _original_add_handler(self, handler)

# 应用补丁
logging.Logger.addHandler = _restricted_add_handler

该方案完全不影响子logger的正常日志逻辑：所有日志事件仍然会正常生成、沿日志层级向上传递到root logger，最终走你配置的JSON格式StreamHandler输出到stdout，不会产生重复日志，也不会丢失任何日志内容。

方案2：全局导入钩子自动清理（无侵入修改logging逻辑） #

如果不希望修改logging模块原生方法，可以注册导入时元路径钩子，在任意模块加载完成后自动清理对应logger上绑定的handler，同样不需要在每个import后写重复样板代码。

import sys
import logging
from importlib.abc import MetaPathFinder, Loader
from importlib.util import find_spec

class _HandlerCleanLoader(Loader):
    def __init__(self, base_loader):
        self.base_loader = base_loader

    def exec_module(self, module):
        # 执行模块原有加载逻辑
        self.base_loader.exec_module(module)
        # 清理模块对应logger的私有handler，强制开启日志向上传播
        module_logger = logging.getLogger(module.__name__)
        module_logger.handlers.clear()
        module_logger.propagate = True

class _HandlerCleanFinder(MetaPathFinder):
    def find_spec(self, fullname, path=None, target=None):
        spec = find_spec(fullname, path, target)
        if not spec or not spec.loader:
            return None
        spec.loader = _HandlerCleanLoader(spec.loader)
        return spec

# 注册钩子，放在meta_path最前端确保最先触发
sys.meta_path.insert(0, _HandlerCleanFinder())

该方案性能略低于猴子补丁，但兼容性更强，不会改动logging模块的原生行为。

注意事项 #

• 以上任意一种方案的初始化代码，都要和你自己的root logger配置逻辑一起，放在项目入口文件的最顶部执行，早于所有第三方库、业务模块的导入语句
• 不要使用直接设置子loggerdisabled=True或者把子logger级别设为CRITICAL以上的方案，这类方案会直接丢弃第三方包的日志，不符合保留日志、仅去重的需求

内容的提问来源于stack exchange，提问作者Z. Kimble