如何消除cPanel日志中的重复条目？

常见原因及对应解决方法 #

1. 重复添加日志Handler #

这是最常见的问题——如果日志配置代码被多次执行（比如在函数里重复调用addHandler），同一个logger会绑定多个Handler，每条日志就会被输出多次。

解决方法：配置logger前先检查是否已有Handler，避免重复添加：

import logging

def get_my_logger():
    logger = logging.getLogger("My App")
    # 仅当没有Handler时才添加新的
    if not logger.hasHandlers():
        # 定义自定义格式
        formatter = logging.Formatter("[%(asctime)s] [%(levelname)s] [My App] %(message)s")
        stream_handler = logging.StreamHandler()
        stream_handler.setFormatter(formatter)
        logger.addHandler(stream_handler)
        logger.setLevel(logging.INFO)
    return logger

# 使用logger
my_logger = get_my_logger()
my_logger.info("going to get milk...")

2. 自定义Logger与Root Logger的输出叠加 #

Python logging模块默认会将自定义Logger的日志传递给Root Logger（propagate属性默认是True）。如果Root Logger也配置了Handler，就会导致同一条日志被输出两次。

解决方法：关闭自定义Logger的日志传递：

logger = logging.getLogger("My App")
# 阻止日志向上传递给Root Logger
logger.propagate = False

3. 第三方库的日志输出 #

如果重复的日志来自你引入的第三方库，可以直接定位并调整该库的Logger配置：

1. 先排查所有已注册的Logger，找到重复日志的来源：

# 打印所有已存在的Logger及其Handler数量
for logger_name in logging.Logger.manager.loggerDict:
    logger = logging.getLogger(logger_name)
    print(f"Logger名称: {logger_name}, Handler数量: {len(logger.handlers)}")

2. 针对目标Logger禁用其Handler或调整日志级别：

# 假设重复日志来自名为"AppInternalLogger"的第三方Logger
third_party_logger = logging.getLogger("AppInternalLogger")
# 移除它的所有Handler，停止输出
for handler in third_party_logger.handlers[:]:
    third_party_logger.removeHandler(handler)
# 或者设置更高的日志级别，只输出警告及以上内容
third_party_logger.setLevel(logging.WARNING)

验证效果 #

配置完成后，再执行日志输出操作，就能看到重复的条目被抑制，只保留你需要的[2022-09-22 11:35:32,079] [INFO] [My App] going to get milk...格式日志。

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