Python logging类多次实例化后重复记录日志问题求助

这个问题的核心原因很明确：你每次实例化模块时，都给同一个日志Logger对象重复添加了日志处理器（Handler）。Python的logging模块里，Logger是按名称全局管理的——比如你用__name__作为Logger名称的话，所有实例化的对象都会拿到同一个Logger实例。每实例化一次就加一个Handler，最终Handler的数量等于实例化次数，每条日志自然会被每个Handler各写一次。

下面是几种无需限制对象实例化次数的解决方案，按推荐程度排序：

1. 模块级别一次性配置日志（最简洁） #

把日志的配置逻辑放在模块的顶层，而不是类的__init__方法里。这样模块加载时只会执行一次配置，后续所有实例化的对象都共享同一个已配置好的Logger：

import logging

# 模块加载时执行一次，全局生效
logger = logging.getLogger(__name__)
logger.setLevel(logging.INFO)

# 配置文件Handler
file_handler = logging.FileHandler('module.log')
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)
logger.addHandler(file_handler)

class YourModule:
    def __init__(self):
        # 直接使用模块预配置的Logger
        self.logger = logger
    
    def do_something(self):
        self.logger.info("执行了某个操作")

2. 实例化时检查Handler是否已存在 #

如果必须在类的__init__里处理日志配置，可以先检查目标Handler是否已经存在于Logger中，不存在再添加：

import logging

class YourModule:
    def __init__(self):
        self.logger = logging.getLogger(__name__)
        self.logger.setLevel(logging.INFO)
        
        # 检查是否已有同名的FileHandler
        target_log_file = 'module.log'
        handler_exists = any(
            isinstance(hdlr, logging.FileHandler) 
            and hdlr.baseFilename.endswith(target_log_file) 
            for hdlr in self.logger.handlers
        )
        
        if not handler_exists:
            file_handler = logging.FileHandler(target_log_file)
            formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
            file_handler.setFormatter(formatter)
            self.logger.addHandler(file_handler)
    
    def do_something(self):
        self.logger.info("执行了某个操作")

这里通过遍历Logger的handlers列表，判断是否已经存在指向目标日志文件的FileHandler，避免重复添加。

3. 使用日志配置字典统一管理 #

如果你的项目日志配置比较复杂，可以用logging.config.dictConfig来统一配置，同样确保配置只执行一次：

import logging
import logging.config

def setup_logging():
    # 只有当Logger没有Handler时才执行配置
    if not logging.getLogger(__name__).handlers:
        logging.config.dictConfig({
            'version': 1,
            'disable_existing_loggers': False,
            'formatters': {
                'standard': {
                    'format': '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
                }
            },
            'handlers': {
                'file': {
                    'class': 'logging.FileHandler',
                    'filename': 'module.log',
                    'formatter': 'standard',
                    'level': 'INFO'
                }
            },
            'loggers': {
                __name__: {
                    'handlers': ['file'],
                    'level': 'INFO',
                    'propagate': False  # 禁止日志向上传播到父Logger，避免额外重复
                }
            }
        })

class YourModule:
    def __init__(self):
        setup_logging()
        self.logger = logging.getLogger(__name__)
    
    def do_something(self):
        self.logger.info("执行了某个操作")

额外注意点 #

• 如果你使用了logging.basicConfig，要注意它只会在第一次调用时生效，后续调用不会重复配置，但如果手动添加Handler，还是会出现重复问题。
• 设置logger.propagate = False可以防止日志被父级Logger的Handler再次处理，避免潜在的多层重复。

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