如何使用Python Django Middleware拦截并记录全局请求日志?

浅瑶吖_2005

浅瑶吖_2005

2026-06-04

879人浏览

原创

Django中间件必须实现__call__方法或继承BaseMiddleware,否则日志不输出;需调用self.get_response(request)避免中断请求链;必须使用logging而非print,并在settings中配置对应logger;位置应紧邻CommonMiddleware之后、AuthenticationMiddleware之前。

如何使用python django middleware拦截并记录全局请求日志?

Middleware 类必须继承 BaseMiddleware 或实现 __call__ 方法

Django 4.1+ 推荐用函数式中间件或继承 BaseMiddleware,旧版的 process_request 等方法在 ASGI 模式下可能不触发。直接写类但没实现 __call__,日志就完全不会打出来。

正确做法是让中间件类可调用,并在内部调用 self.get_response(request):

class RequestLoggingMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response
<pre class="brush:python;toolbar:false;">def __call__(self, request):
    # 记录请求开始时间、路径、方法
    import time
    request._log_start_time = time.time()
    response = self.get_response(request)
    # 记录耗时、状态码等
    duration = time.time() - request._log_start_time
    print(f"[{request.method}] {request.path} → {response.status_code} ({duration:.3f}s)")
    return response
  • 别漏掉 self.get_response(request) 调用,否则请求链中断,返回 500
  • request 对象是线程/协程局部的,可以安全加临时属性(如 _log_start_time)
  • 若用 BaseMiddleware,需显式调用 super().__init__(get_response),且仍要重写 __call__

日志写入不能只靠 print,得用 logging 配合 settings.LOGGING

print 在生产环境会被丢弃,Gunicorn/Uvicorn 不捕获 stdout;必须走 Python 标准 logging,并确保 Django 的 LOGGING 配置已启用对应 handler。

推荐在中间件里获取命名 logger:

Biopython
Biopython

全面的分子生物学工具集。适用于序列操作、文件解析(FASTA/GenBank/PDB)、系统发育分析,以及通过 Bio.Entrez 以编程方式访问 NCBI/

下载
import logging
logger = logging.getLogger('django.request.log')
<p>class RequestLoggingMiddleware:
def <strong>init</strong>(self, get_response):
self.get_response = get_response</p><pre class="brush:python;toolbar:false;">def __call__(self, request):
    response = self.get_response(request)
    logger.info(
        '%s %s %d %0.3f',
        request.method,
        request.path,
        response.status_code,
        getattr(request, '_log_start_time', 0),
        extra={'request': request, 'response': response}
    )
    return response
  • 在 settings.py 中必须定义名为 'django.request.log' 的 logger,否则日志静默丢失
  • 避免在 extra 里传复杂对象(如 request.POST),可能触发懒加载或报错
  • 敏感字段(如 Authorization header、password 参数)需主动过滤,不要直接打全量 request.META

中间件顺序错位会导致日志缺失或重复

比如把日志中间件放在 SecurityMiddleware 之后,但请求被其拦截(如 HTTPS 重定向),你就收不到原始请求日志;若放在 AuthenticationMiddleware 之前,request.user 就是 AnonymousUser,无法记录真实用户 ID。

  • 推荐位置:紧挨着 CommonMiddleware 之后、AuthenticationMiddleware 之前
  • 如果依赖 request.user,必须放 AuthenticationMiddleware 之后,但要注意 401/403 响应可能绕过它
  • 调试时可在 settings.MIDDLEWARE 列表中临时插入 print(repr(mw)) 查看加载顺序

异步视图和流式响应(如 StreamingHttpResponse)会让耗时统计失真

中间件的 __call__ 在响应体真正生成前就返回了,对 StreamingHttpResponse 或异步视图,time.time() - start 只反映到响应头发出的时间,不包括流传输耗时。

  • 无法准确统计流式响应总耗时,只能记录“首字节时间”
  • 异步视图需用 async def __call__ + await self.get_response(request),否则会阻塞事件循环
  • 若需完整耗时,得在视图内手动埋点,或改用 APM 工具(如 Sentry Performance)

Django 中间件日志看似简单,但真实请求链里有重定向、认证跳转、流响应、ASGI 并发多个变量,光靠一个 call 拦截很难覆盖所有情况。最常被忽略的是:没配 LOGGING 导致日志消失,以及把中间件放错位置后死活看不到输出。

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

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

django python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.07.20

1911

4

python能做什么
python能做什么

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

2023.07.25

5324

7

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

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

2023.07.31

1849

3

python教程
python教程

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

2023.08.03

32317

23

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

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

2023.08.04

3807

5

python eval
python eval

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

2023.08.04

3827

5

scratch和python区别
scratch和python区别

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

2023.08.11

1263

5

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

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

2023.08.10

616

4

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

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

2023.08.11

2963

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 6.1 官方文档
Django 6.1 官方文档

共0课时 | 0人学习

Django 教程
Django 教程

共28课时 | 10万人学习

Django DRF 源码解析
Django DRF 源码解析

共21课时 | 2.1万人学习