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

如何正确配置 Python 日志以避免重复写入和日志文件刷屏

本文详解 logging 模块中因重复调用 addHandler() 导致日志被多次写入同一文件的问题，并提供一次性初始化、分离日志器、避免 basicConfig 冗余调用等专业解决方案。

本文详解 logging 模块中因重复调用 `addhandler()` 导致日志被多次写入同一文件的问题，并提供一次性初始化、分离日志器、避免 `basicconfig` 冗余调用等专业解决方案。

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

logger = logging.getLogger(__name__)
logger.addHandler(handler)  # ⚠️ 每次都新增一个 handler！

这正是 anomaly.log 被严重刷屏的根本原因：每秒向同一个 logger 实例添加一个新 FileHandler，导致第 n 秒时该 logger 拥有 n 个 handler；每次 logging.info() 调用都会被所有 handler 同时处理——因此一条日志被重复写入 n 次。

与此同时，bandit.log 看似“正常”，实则也受干扰：logging.basicConfig(...) 在首次调用时生效，但后续调用（如 bandit_cycle() 中的 logging.info()）会复用已配置的 root logger，而该 logger 的 handler 又被 logger() 不断污染，造成日志混杂与输出不可控。

✅ 正确做法是：将日志配置逻辑移出循环/定时任务，仅执行一次，并为不同用途创建独立、命名明确的日志器（Logger），避免共享 root logger 或重复绑定 handler。

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

下载

以下是重构后的推荐方案：

✅ 1. 一次性初始化两个专用日志器

import logging
import pyautogui
import schedule
import time

# --- 日志器初始化（仅执行一次！）---
# Bandit 日志器：写入 bandit.log，不传播到 root
bandit_logger = logging.getLogger("bandit")
bandit_logger.setLevel(logging.INFO)
bandit_handler = logging.FileHandler("bandit.log", mode="w")
bandit_handler.setFormatter(logging.Formatter("%(asctime)s - %(levelname)s - %(message)s"))
bandit_logger.addHandler(bandit_handler)
bandit_logger.propagate = False  # 关键：阻止向上级（root）传递

# Anomaly 日志器：写入 anomaly.log，独立管理
anomaly_logger = logging.getLogger("anomaly")
anomaly_logger.setLevel(logging.INFO)
anomaly_handler = logging.FileHandler("anomaly.log", mode="w")
anomaly_handler.setFormatter(logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s"))
anomaly_logger.addHandler(anomaly_handler)
anomaly_logger.propagate = False
# -- 初始化结束 --

call_count = 0

def logger():
    global call_count
    try:
        location = pyautogui.locateOnScreen('1.png', confidence=0.9)
        if location:  # 避免重复 locate，提升性能
            call_count += 1
            anomaly_logger.info(f"Found match #{call_count}")  # ✅ 使用专用日志器
    except pyautogui.ImageNotFoundException:
        pass

def bandit_cycle():
    try:
        location = pyautogui.locateOnScreen('1.png', confidence=0.9)
        if location:
            bandit_logger.info('x1 Data found')
        time.sleep(1.5)
    except Exception as e:
        bandit_logger.error(f"Error in bandit_cycle: {e}")

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

while True:
    schedule.run_pending()
    time.sleep(1)

? 关键修复点说明：

禁止在定时函数中初始化日志器：所有 getLogger() + addHandler() 必须在主流程顶部执行一次；
显式命名日志器（如 "bandit" / "anomaly"）：避免默认 __name__ 导致冲突，便于追踪来源；
关闭 propagate：防止日志经 root logger 二次输出（尤其当 basicConfig 已启用控制台输出时）；
避免 logging.basicConfig() 与自定义 handler 混用：它仅对 root logger 生效，且多次调用无效，易引发配置混乱；
优化图像查找：locateOnScreen 耗时，不应调用两次，应缓存结果。