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顶部或者原来日志配置信息全部删除后的地方
)
)
