如何阻止第三方库配置日志及添加自定义Handler？

我正在编写一个应用，采用以下方式配置logging：

import logging.config

loglevel = "INFO"

logging.config.dictConfig({
    "version": 1,
    "disable_existing_loggers": False,
    "formatters": {
        "my_formatter": {
            "format": "%(asctime)s [%(levelname)s] %(name)s: %(message)s",
        },
    },
    "handlers": {
        "my_handler": {
            "level": loglevel,
            "formatter": "my_formatter",
            "class": "logging.StreamHandler",
            "stream": "ext://sys.stdout",
        },
    },
    "loggers": {
        "my_app": {
            "level": loglevel,
        },
        # emits too much on DEBUG and INFO, so it should be WARNING at least
        "noisy_third_party_logger": {
            "level": max(logging.WARNING, logging._nameToLevel[loglevel]),
        },
    },
    "root": {  # catch all propagated records and handle them
        "handlers": ["my_handler"],
    },
})

尽管第三方库本不应自行配置logging，但部分库仍会出于各种原因（可能合理也可能不合理）这么做。我最大的痛点是它们会附加自己的handler，因此我在logging模块中寻找一种“冻结”当前日志配置的方法，仅允许添加可传播（propagating）的loggers。遗憾的是，目前没有这样的方法，而且查看源码后，我也不敢自行进行猴子补丁（monkey-patch）。

我的需求如下：

• 希望第三方库能够输出日志，即使我未在"loggers"字典中显式列出它们的logger
  • 因此我不想将"disable_existing_loggers"设置为True
• 不希望第三方库为任何logger附加自定义handler
• 我想强制所有logger进行传播（propagate），但不确定这是否是个好主意

请问是否有安全的实现方法，或者已有可安装的日志包装库能实现这些需求？

1. 拦截Handler添加操作（安全的猴子补丁） #

不用直接修改logging核心逻辑，给Logger类的addHandler方法加一层包装，只允许自己定义的handler被添加，或者直接阻止第三方新增handler：

import logging

original_addHandler = logging.Logger.addHandler

def restricted_addHandler(self, handler):
    # 只允许添加我们定义的my_handler，可根据实际情况调整判断逻辑
    allowed_handlers = [h for h in logging.root.handlers if getattr(h, 'name', '') == "my_handler"]
    if any(isinstance(handler, type(h)) and handler.stream == h.stream for h in allowed_handlers):
        return original_addHandler(self, handler)
    # 对非法添加操作抛出警告并忽略
    logging.warning(f"Attempted to add unauthorized handler {handler} to logger {self.name}")

logging.Logger.addHandler = restricted_addHandler

将这段代码放在你的日志配置之后执行，就能有效阻止第三方库添加自定义handler。

2. 强制所有Logger开启传播 #

遍历所有已存在的logger，同时拦截新logger的创建过程，强制设置propagate=True：

import logging

# 处理已存在的logger
for logger_name in logging.Logger.manager.loggerDict:
    logger = logging.getLogger(logger_name)
    logger.propagate = True

# 拦截新logger的创建，强制开启传播
original_getLogger = logging.getLogger

def getLogger_propagate(name):
    logger = original_getLogger(name)
    logger.propagate = True
    return logger

logging.getLogger = getLogger_propagate

这样所有logger（包括第三方库创建的）都会将日志传播到root logger，由你定义的统一handler处理。这种方式仅修改logger的属性，不会触碰核心日志流转逻辑，安全性较高。

3. 第三方工具辅助 #

• 使用logging_tree可以可视化当前日志配置，快速排查第三方库添加的handler和logger；
• structlog虽主打结构化日志，但可通过其配置层接管所有日志输出，避免第三方库的handler干扰——你可以选择将自身日志切换到structlog接口，或使用它的兼容包装适配原生logging。

关于强制传播的合理性 #

强制所有logger开启传播是可行的，只要你的root logger配置了统一handler，就能确保所有日志按指定格式输出。需要注意的是，如果第三方库的logger设置了较高级别（如ERROR），即使root级别更低（如INFO），仍会输出该logger的ERROR日志，这符合预期；若担心部分库日志过杂，仍可像原配置那样单独设置其级别。

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