Python Tkinter 实战:文件日志 + 数据库的双轨记录系统

🧩 先说说这事儿的来龙去脉

做过桌面工具的朋友，多少都踩过这个坑——程序跑着跑着出了问题，你打开一看，日志？没有。数据库记录？空的。只剩一个报错弹窗，连个回溯的线索都没给你留。

这不是代码写得烂，是架构设计漏了一环。

日志和数据库，本质上是两种不同维度的记录手段。 文件日志是时序流水账，适合排查"什么时间发生了什么"；数据库则是结构化存档，适合做统计、筛选、分析。两者不是竞争关系，而是互补的——就像监控录像和案件档案，缺一不可。

今天咱们就用 Tkinter 搭一个真实可用的桌面应用，把这两套机制整合进去，做成一个操作行为双轨记录系统。用户在界面上的每一步操作，既写进 .log 文件，也存进 SQLite 数据库，随时可查、可导出、可分析。

文章涵盖：

• • logging 模块的进阶配置（不只是 basicConfig）
• • SQLite 与 Tkinter 的整合方式
• • 多线程写入的安全性处理
• • 日志查询界面的实现

代码全部可运行，Windows 环境验证过。

🏗️ 整体架构先捋一遍

别急着写代码。先把脑子里的结构理清楚，后面写起来才不会乱。

三层结构：界面层触发事件，核心层双写，展示层读取查询。干净，职责清晰，改哪层不影响另外两层。

🔧 环境准备

Python 标准库全家桶，不需要额外安装第三方包：

# 用到的模块清单
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import logging
import sqlite3
import threading
import os
import csv
from datetime import datetime

SQLite 是 Python 内置的，logging 也是，Tkinter 在 Windows 下随 Python 一起装好了。零依赖，拿来就能跑。

📁 第一轨：文件日志的"正确打开方式"

很多人用 logging 只会写这一行：

logging.basicConfig(filename='app.log', level=logging.DEBUG)

能用，但太粗糙了。生产环境里这样搞，日志文件会无限增长，出了问题翻起来像大海捞针。

咱们来配一个按日期滚动、带格式、分级别的文件日志器：

import logging
from logging.handlers import TimedRotatingFileHandler
import os

defsetup_file_logger(log_dir="logs"):
"""
    配置文件日志器
    - 按天滚动，保留最近 7 天
    - 同时输出到控制台（开发调试用）
    """
    os.makedirs(log_dir, exist_ok=True)

    logger = logging.getLogger("AppLogger")
    logger.setLevel(logging.DEBUG)

# 避免重复添加 handler（Tkinter 应用可能多次初始化）
if logger.handlers:
return logger

    log_path = os.path.join(log_dir, "app.log")

# 按天滚动，保留 7 天
    file_handler = TimedRotatingFileHandler(
        filename=log_path,
        when="midnight",       # 每天零点滚动
        interval=1,
        backupCount=7,
        encoding="utf-8"
    )
    file_handler.setLevel(logging.DEBUG)

# 格式：时间 | 级别 | 模块 | 消息
    formatter = logging.Formatter(
        fmt="%(asctime)s | %(levelname)-8s | %(module)s | %(message)s",
        datefmt="%Y-%m-%d %H:%M:%S"
    )
    file_handler.setFormatter(formatter)

# 控制台 handler（只输出 WARNING 以上）
    console_handler = logging.StreamHandler()
    console_handler.setLevel(logging.WARNING)
    console_handler.setFormatter(formatter)

    logger.addHandler(file_handler)
    logger.addHandler(console_handler)

return logger

TimedRotatingFileHandler 是个被严重低估的工具——它会在每天零点自动把旧日志重命名为 app.log.2026-03-16，新的写进 app.log，完全不需要你手动管理。backupCount=7 保留最近 7 天，超出的自动删掉，磁盘空间稳稳的。

🗄️ 第二轨：SQLite 日志表的设计

文件日志适合人眼阅读，但你要是想查"过去一周内，用户点击'导出'按钮超过 3 次的记录"，用 grep 翻日志文件……算了，还是用 SQL 吧。

import sqlite3
import threading
from datetime import datetime

classDBLogger:
"""
    SQLite 日志记录器
    线程安全版本——Tkinter 多线程操作时不会写坏数据库
    """

def__init__(self, db_path="logs/app_logs.db"):
self.db_path = db_path
self._lock = threading.Lock()  # 关键：写入锁
        os.makedirs(os.path.dirname(db_path), exist_ok=True)
self._init_db()

def_init_db(self):
"""建表，如果不存在的话"""
with sqlite3.connect(self.db_path) as conn:
            conn.execute("""
                CREATE TABLE IF NOT EXISTS operation_logs (
                    id          INTEGER PRIMARY KEY AUTOINCREMENT,
                    timestamp   TEXT    NOT NULL,
                    level       TEXT    NOT NULL,
                    module      TEXT,
                    action      TEXT    NOT NULL,
                    detail      TEXT,
                    user        TEXT    DEFAULT 'default',
                    duration_ms INTEGER DEFAULT 0
                )
            """)
# 给常用查询字段加索引，数据量大了之后查询不卡
            conn.execute("""
                CREATE INDEX IF NOT EXISTS idx_timestamp 
                ON operation_logs(timestamp)
            """)
            conn.execute("""
                CREATE INDEX IF NOT EXISTS idx_level 
                ON operation_logs(level)
            """)
            conn.commit()

defwrite(self, level, action, detail="", module="", duration_ms=0):
"""
        写入一条日志记录
        用锁保证多线程安全
        """
        timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f")[:-3]

withself._lock:
try:
with sqlite3.connect(self.db_path) as conn:
                    conn.execute("""
                        INSERT INTO operation_logs 
                        (timestamp, level, module, action, detail, duration_ms)
                        VALUES (?, ?, ?, ?, ?, ?)
                    """, (timestamp, level, module, action, detail, duration_ms))
                    conn.commit()
except sqlite3.Error as e:
# 数据库写失败不能让主程序崩，静默记录到文件日志
                logging.getLogger("AppLogger").error(
f"DB write failed: {e} | action={action}"
                )

defquery(self, level=None, keyword=None, limit=200):
"""
        查询日志记录
        支持按级别过滤、关键词搜索
        """
        sql = "SELECT * FROM operation_logs WHERE 1=1"
        params = []

if level and level != "ALL":
            sql += " AND level = ?"
            params.append(level)

if keyword:
            sql += " AND (action LIKE ? OR detail LIKE ?)"
            params.extend([f"%{keyword}%", f"%{keyword}%"])

        sql += " ORDER BY id DESC LIMIT ?"
        params.append(limit)

with sqlite3.connect(self.db_path) as conn:
            conn.row_factory = sqlite3.Row  # 让结果支持列名访问
            cursor = conn.execute(sql, params)
return cursor.fetchall()

这里有个细节值得说一下：_lock = threading.Lock()。Tkinter 的事件循环跑在主线程，但如果你在后台线程做耗时操作（比如批量导入数据），同时触发日志写入，SQLite 的默认配置下会抛 database is locked 错误。加锁之后，写入操作串行化，稳得很。

🧠 核心层：LogManager 统一调度

两个日志器单独用没问题，但每次写日志都要调两次，代码会散。封装一个 LogManager，对外只暴露一个接口：

classLogManager:
"""
    双轨日志管理器
    一次调用，同时写文件 + 数据库
    """

def__init__(self):
self.file_logger = setup_file_logger()
self.db_logger = DBLogger()
self._module = "App"

defset_module(self, module_name):
self._module = module_name
returnself# 支持链式调用

def_write(self, level, action, detail="", duration_ms=0):
# 写文件日志
        log_msg = f"[{action}] {detail}"if detail elsef"[{action}]"
getattr(self.file_logger, level.lower())(log_msg)

# 写数据库
self.db_logger.write(
            level=level,
            action=action,
            detail=detail,
            module=self._module,
            duration_ms=duration_ms
        )

definfo(self, action, detail="", duration_ms=0):
self._write("INFO", action, detail, duration_ms)

defwarning(self, action, detail="", duration_ms=0):
self._write("WARNING", action, detail, duration_ms)

deferror(self, action, detail="", duration_ms=0):
self._write("ERROR", action, detail, duration_ms)

defdebug(self, action, detail="", duration_ms=0):
self._write("DEBUG", action, detail, duration_ms)

defquery(self, **kwargs):
"""透传给 DBLogger 的查询接口"""
returnself.db_logger.query(**kwargs)

调用方式就变成这样，清爽：

log = LogManager()
log.info("用户登录", "用户 admin 登录成功")
log.warning("文件导入", "文件格式不标准，已自动修正")
log.error("数据库连接", "连接超时，重试第 2 次")

🖥️ Tkinter 界面：主操作区

现在把界面搭起来。主窗口分两个区域：上方是操作面板（模拟用户的各种操作），下方是实时日志流。