如何正确配置 Python 日志以避免重复写入和日志爆炸

落杰君_3377

落杰君_3377

2026-09-24

799人浏览

原创

如何正确配置 Python 日志以避免重复写入和日志爆炸

本文详解 logging 模块中因多次调用 addHandler() 导致日志文件被重复写入(如 anomaly.log 被高频刷屏)的根本原因,并提供一次性初始化、分离日志器、禁用传播等专业解决方案。

本文详解 logging 模块中因多次调用 `addhandler()` 导致日志文件被重复写入(如 anomaly.log 被高频刷屏)的根本原因,并提供一次性初始化、分离日志器、禁用传播等专业解决方案。

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

logger = logging.getLogger(__name__)
logger.addHandler(handler)  # ❌ 每次都新增一个 handler!

这导致同一个 logger 实例累积了数十甚至上百个 FileHandler('anomaly.log') —— 每次 logging.info() 触发时,所有 handler 同时写入,造成 anomaly.log 中同一行日志重复出现 N 次(N = 当前 handler 数量),而 bandit.logbasicConfig() 仅在首次生效,看似“正常”,实则也已混入冗余日志。

✅ 正确做法:日志配置应「只初始化一次」

将日志器创建与 handler 添加移出循环逻辑,在程序启动时完成全局配置:

Python Matplotlib Chinese Font
Python Matplotlib Chinese Font

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

下载
import pyautogui
import schedule
import time
import logging

# ✅ 全局日志器初始化(仅执行一次)
def setup_logging():
    # 主日志器:输出到 bandit.log(覆盖模式)
    logging.basicConfig(
        level=logging.INFO,
        filename="bandit.log",
        filemode="w",
        format="%(asctime)s - %(levelname)s - %(message)s"
    )

    # 独立的 anomaly 日志器(不继承 root,避免传播干扰)
    anomaly_logger = logging.getLogger("anomaly")
    anomaly_logger.setLevel(logging.INFO)
    anomaly_logger.propagate = False  # ⚠️ 关键:禁止向 root 传播

    # 添加专属 FileHandler 到 anomaly_logger
    anomaly_handler = logging.FileHandler("anomaly.log", mode="a")  # 追加模式更安全
    anomaly_formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
    anomaly_handler.setFormatter(anomaly_formatter)

    # ✅ 只添加一次 handler(检查是否已存在,防重复)
    if not anomaly_logger.handlers:
        anomaly_logger.addHandler(anomaly_handler)

    return anomaly_logger

# 初始化并复用该日志器
anomaly_logger = setup_logging()

# 全局计数器(建议改用 nonlocal 或类封装,此处简化保留)
call_count = 0

def logger():
    global call_count
    try:
        location = pyautogui.locateOnScreen('1.png', confidence=0.9)
        if location:  # 避免重复调用 locateOnScreen
            call_count += 1
            anomaly_logger.info(call_count)  # ✅ 使用专用日志器
    except pyautogui.ImageNotFoundException:
        pass

def bandit_cycle():
    try:
        location = 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}")

# ⚠️ 注意:原代码中 schedule.every(...).do(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)

? 关键修复点总结

  • ? 禁止在循环/定时任务中调用 basicConfig()addHandler():它们不是幂等操作;
  • ✅ 使用命名日志器(如 "anomaly")替代 __name__:避免与模块级 logger 混淆;
  • ?️ 设置 propagate = False:防止日志向上冒泡至 root logger,引发交叉写入;
  • ? 添加 handler 前检查 if not logger.handlers::防御性编程,确保唯一性;
  • ✏️ filemode="a"(追加)优于 "w"(覆盖):避免定时任务重启时清空历史日志。

? 提示:若需动态控制日志级别或实时刷新日志,可进一步结合 logging.config.dictConfig() 或使用 RotatingFileHandler 实现自动轮转,提升生产环境健壮性。

通过以上重构,anomaly.log 将严格按实际调用次数写入单条记录,bandit.log 保持清晰独立,彻底解决日志爆炸问题。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1571

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3724

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1569

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

21337

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2627

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2687

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1083

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

576

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2083

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程