Django 用 Loguru 完美替换标准 Logging，实现优雅的日志管理方案

Django 用 Loguru 完美替换标准 Logging，实现优雅的日志管理方案

这篇文章将详细拆解如何将强大的 loguru 库深度集成到 Django 项目中，彻底解决原生 logging 配置冗长、难以维护的痛点。

---

为什么要进行方案替换

Django 默认的日志配置通过 LOGGING 字典实现，嵌套层级多且语法繁琐。相比之下，loguru 提供了更直观的 API 和自动化的日志轮转管理。

核心技术要点

• 全量拦截 ：通过自定义 InterceptHandler 类，将 Django 内置、Gunicorn 容器以及第三方库产生的标准 logging 消息全部重定向至 loguru。

• 精准溯源 ：利用 sys._getframe 动态查找调用栈，确保日志中显示的文件名和行号是真实的业务逻辑位置，而非拦截器本身。

• 自动化策略：配置文件输出时，只需一行代码即可实现凌晨定时切割日志（rotation）和 30 天自动清理（retention）。

• 并发安全 ：开启 enqueue=True 选项，利用多线程/进程安全的队列机制，防止高并发下日志写入冲突。

部署实践：一键接管 Django 日志

在项目中创建日志工具模块后，只需在 settings.py 顶部导入，并设置 LOGGING_CONFIG = None 即可禁用 Django 原生逻辑。

Python

import os
import sys
import logging
from pathlib import Path
from loguru import logger

# 路径初始化
BASE_DIR = Path(__file__).resolve().parent.parent
log_dir = os.path.join(BASE_DIR, "logs")
log_file_path = os.path.join(log_dir, "dt_test.log")
if not os.path.exists(log_dir):
    os.makedirs(log_dir)

# 拦截器定义：核心在于深度(depth)的计算
class InterceptHandler(logging.Handler):
    def emit(self, record):
        try:
            level = logger.level(record.levelname).name
        except ValueError:
            level = record.levelno
        frame, depth = sys._getframe(6), 6
        while frame and frame.f_code.co_filename == logging.__file__:
            frame = frame.f_back
            depth += 1
        logger.opt(depth=depth, exception=record.exc_info).log(level, record.getMessage())

# 彻底接管配置
LOGGING_CONFIG = None

def setup_loguru(debug_mode: bool = True):
    logger.remove()
    log_format = "{time:YYYY-MM-DD HH:mm:ss,SSS} | {level: <8} | {name} [{module}.{function}:{line}] | {message}"
    
    # 控制台调试输出
    if debug_mode:
        logger.add(sys.stdout, level="DEBUG", format=log_format, enqueue=True)

    # 文件持久化配置：支持每天凌晨切割与压缩
    logger.add(
        log_file_path, level="DEBUG", format=log_format, rotation="00:00", 
        retention="30 days", encoding="utf-8", enqueue=True, compression="zip"
    )

    # 重定向系统级日志
    logging.basicConfig(handlers=[InterceptHandler()], level=0, force=True)
    for name in ["django", "django.server", "gunicorn.access", "gunicorn.error"]:
        _log = logging.getLogger(name)
        _log.handlers = [InterceptHandler()]
        _log.propagate = False

setup_loguru()

---

放在settings.py顶部或者原来日志配置信息全部删除后的地方

效果