如何正确配置 Python 日志避免重复写入与句柄堆积-Python教程-PHP中文网

如何正确配置 Python 日志避免重复写入与句柄堆积

本文详解 logging 模块中因多次调用 addHandler() 导致日志文件被重复写入的根本原因，并提供一次性初始化、分离 logger 实例、禁用 propagate 等专业解决方案，确保多任务调度下日志行为稳定可靠。

本文详解 logging 模块中因多次调用 `addhandler()` 导致日志文件被重复写入的根本原因，并提供一次性初始化、分离 logger 实例、禁用 propagate 等专业解决方案，确保多任务调度下日志行为稳定可靠。

问题核心在于：logger.addHandler(handler) 被反复执行，导致同一 logger 对象累积了多个 FileHandler，每次 logging.info() 都触发所有 handler 同步写入，造成 anomaly.log 被“刷屏”式重复记录（如单次调用输出 10 行相同日志）。而 bandit.log 表面正常，实则也受 basicConfig() 多次调用干扰——但因其使用默认 root logger 且未显式添加额外 handler，故未暴露同样严重的重复问题。

✅ 正确做法：日志配置仅初始化一次

应将日志配置（basicConfig、getLogger、addHandler）移出循环/定时函数，放在模块顶层或 if __name__ == "__main__": 块中，确保全局唯一初始化：

import pyautogui
import schedule
import time
import logging

# ✅ 全局日志初始化（只执行一次）
logging.basicConfig(
    level=logging.INFO,
    filename="bandit.log",
    filemode="w",
    format="%(asctime)s - %(levelname)s - %(message)s"
)

# 创建专用 logger 实例用于 anomaly.log
anomaly_logger = logging.getLogger("anomaly")
anomaly_logger.setLevel(logging.INFO)
anomaly_logger.propagate = False  # ❗关键：阻止日志向 root logger 传播

# 添加专属 FileHandler（仅一次）
anomaly_handler = logging.FileHandler("anomaly.log")
anomaly_handler.setFormatter(
    logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
)
anomaly_logger.addHandler(anomaly_handler)

# 全局计数器
call_count = 0

def logger():
    global call_count
    try:
        if pyautogui.locateOnScreen('1.png', confidence=0.9):
            call_count += 1
            anomaly_logger.info(call_count)  # ✅ 使用专用 logger
    except pyautogui.ImageNotFoundException:
        pass

def bandit_cycle():
    try:
        if pyautogui.locateOnScreen('1.png', confidence=0.9):
            logging.info('x1 Data found')  # ✅ 使用 root logger（即 bandit.log）
        time.sleep(1.5)
    except Exception as e:
        logging.error(f"Bandit cycle error: {e}")

# ✅ 调度任务（注意：原代码中 bandit_main 未定义，此处修正为 bandit_cycle）
schedule.every(1).seconds.do(bandit_cycle)
schedule.every(1).seconds.do(logger)

if __name__ == "__main__":
    while True:
        schedule.run_pending()
        time.sleep(1)

⚠️ 关键注意事项

propagate=False 不可省略：否则 anomaly_logger 的日志会同时流向自身 handler 和 root logger（即 bandit.log），造成跨文件污染；
避免在函数内调用 basicConfig() 或 addHandler()：它们不是幂等操作，重复执行必导致 handler 堆积；
区分 logger 实例：logging.getLogger(__name__) 返回的是模块级 logger，但若需多目标输出，应显式命名（如 "anomaly"）并独立管理；
异常捕获要具体：原代码 except: 过于宽泛，建议捕获 pyautogui.ImageNotFoundException 或 Exception 并记录错误详情，便于调试。