如何正确配置 Python 日志系统以避免重复写入日志文件-Python教程-PHP中文网

如何正确配置 Python 日志系统以避免重复写入日志文件

本文详解 logging 模块中因多次调用 addHandler() 导致日志重复写入（如 anomaly.log 被疯狂刷屏）的根本原因，并提供一次性初始化、解耦日志器与业务逻辑的健壮解决方案。

本文详解 logging 模块中因多次调用 `addhandler()` 导致日志重复写入（如 `anomaly.log` 被疯狂刷屏）的根本原因，并提供一次性初始化、解耦日志器与业务逻辑的健壮解决方案。

在您提供的代码中，logger() 函数被 schedule.every(1).seconds.do(logger) 每秒调用一次，而该函数内部反复执行：

logger = logging.getLogger(__name__)
logger.addHandler(handler)  # ⚠️ 关键问题：每次调用都新增一个 Handler！

由于 logging.getLogger(__name__) 在同一进程内始终返回同一个 logger 实例，但 addHandler() 并不会去重或覆盖——它只是不断追加。结果：每秒向 logger 添加一个新 FileHandler，10 秒后就有 10 个 handler；每个 logging.info() 调用都会被这 10 个 handler 同时处理，导致 anomaly.log 中同一行日志重复出现 10 次（甚至更多），而 bandit.log 因使用 basicConfig（仅首次生效）未受此影响，表面“正常”，实则掩盖了设计缺陷。

✅ 正确做法是：将日志配置一次性完成，与业务逻辑完全分离。以下是重构后的专业实践：

Python Matplotlib Chinese Font

使用 font_manager.addfont() 添加中文字体文件，设置 rcParams['font.family']，并禁用 unicode_minus，使 matplotlib 显示中文。

下载

✅ 步骤一：全局日志初始化（仅执行一次）

在脚本最上方或 if __name__ == "__main__": 块中初始化日志系统：

import logging
import pyautogui
import schedule
import time

# === 全局日志配置（只运行一次！） ===
# 配置 bandit.log（覆盖模式）
logging.basicConfig(
    level=logging.INFO,
    filename="bandit.log",
    filemode="w",
    format="%(asctime)s - %(levelname)s - %(message)s",
    encoding="utf-8"
)

# 创建专用 logger 用于 anomaly.log
anomaly_logger = logging.getLogger("anomaly")
anomaly_logger.setLevel(logging.INFO)

# 独立 FileHandler（避免重复添加）
anomaly_handler = logging.FileHandler("anomaly.log", mode="w", encoding="utf-8")
anomaly_formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
anomaly_handler.setFormatter(anomaly_formatter)
anomaly_logger.addHandler(anomaly_handler)
anomaly_logger.propagate = False  # 阻止向上级（root）传播，避免写入 bandit.log

✅ 步骤二：业务函数中直接使用已配置好的 logger

call_count = 0

def logger():
    global call_count
    try:
        location = pyautogui.locateOnScreen('1.png', confidence=0.9)
        if location:  # 推荐用 location 判断，而非重复调用 locateOnScreen
            call_count += 1
            anomaly_logger.info(call_count)  # ✅ 使用专用 logger，无副作用
    except pyautogui.ImageNotFoundException:
        pass

def bandit_cycle():
    try:
        location = pyautogui.locateOnScreen('1.png', confidence=0.9)
        logging.info('x1 Data found')  # ✅ 自动写入 bandit.log（root logger）
        time.sleep(1.5)
    except Exception as e:
        logging.error(f"bandit_cycle error: {e}")

✅ 步骤三：调度与主循环（保持原结构）

schedule.every(1).seconds.do(bandit_cycle)
schedule.every(1).seconds.do(logger)

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