Django框架中间件(Middleware)用法实例分析

桃夭
桃夭
发布时间:2026-10-14| 6人浏览过
原创

本文详解Django框架中中间件(Middleware)的核心机制与用法。文章介绍了面向切面编程在Django中的体现,详细列举了init、process_request、process_view等五个内置切点方法的执行时机与返回值规则。此外,还提供了从创建目录、继承MiddlewareMixin到注册配置的完整自定义中间件开发流程,涵盖统计、黑白名单及异常处理等常见应用场景。

Django中间件概述

本文通过具体实例解析Django框架中中间件(Middleware)的工作机制,旨在为开发者提供清晰的参考与指导。

面向切面编程与切点机制

1、面向切面编程

  • 切点(钩子)
  • 切点机制允许我们在不干扰原有业务逻辑的前提下,动态插入额外的代码片段。
  • 这种机制确保在无需修改原始代码逻辑的情况下,实现代码的动态注入。
  • 默认情况下,请求处理流程不会中断,切点执行完毕后会自动继续执行原有逻辑(即自动愈合)。
  • 若在切点中执行了中断操作(如return返回响应或raise抛出异常),且未将处理链接回原有逻辑,请求将直接结束并返回结果。
  • Django定义了五个主要切面:1、请求在交由路由表处理之前;2、请求在交由视图函数处理之前;3、视图函数渲染完成后;4、渲染结果在返回给模板之前;5、当视图抛出异常时。

Django内置中间件钩子详解

2、Django中的中间件

  • 框架内置切点
    • init
    • 该方法无参数,在服务器响应第一个请求时自动调用,用于确定是否启用该中间件实例。
    • process_request(self,request)
    • 在视图函数执行前被调用,针对每个请求都会触发。
    • 该方法可以不返回任何值,或返回一个HttpResponse对象。
    • process_view(self,request,view_func,view_args,view_kwargs)
    • 在调用视图函数之前执行,针对每个请求都会触发。
    • 该方法可以不返回任何值,或返回一个HttpResponse对象。
    • process_template_response(self,request,response)
    • 在视图函数执行完毕后立即调用,针对每个请求都会触发。
    • 该方法可以不返回任何值,或返回一个HttpResponse对象。
    • process_response(self,request,response)
    • 在所有响应返回浏览器之前调用,针对每个请求都会触发。
    • 该方法可以不返回任何值,或返回一个HttpResponse对象。
    • process_exception(self,request,exception)
    • 当视图函数抛出异常时被调用。
    • 该方法可以不返回任何值,或返回一个HttpResponse对象。

中间件代码实现示例


from django.http import HttpResponse
from django.shortcuts import render, redirect
from django.urls import reverse
from django.utils.deprecation import MiddlewareMixin
from MidUpVcode.settings import BLACK_LIST, VIP_LIST
'''
所有的钩子函数都可以返回一个Response
一旦钩子函数返回了Response,整个请求的受理就结束了
'''
# 继承于框架中间件
class MyappMiddleware(MiddlewareMixin):
 # 中间件的初始化方法,全局执行一次
 # def __init__(self, get_response=None):
 #   super(MyappMiddleware, self).__init__()
 #   print(">>>>>>>>>> MyappMiddlware __init__")
 # 下钩子于所有路由被交给路由表之前
 def process_request(self, request):
   # 获取客户端IP地址
   clientIp = request.META['REMOTE_ADDR']
   # 请求的路由
   url = request.path
   print(">>> process_request", request, clientIp, url)
   # # 屏蔽黑名单用户
   # 只要客户端IP在黑名单中
   # if clientIp in BLACK_LIST:
   #   直接渲染fuckoff.html并立刻返回
   #   return render(request,'fuckoff.html')
   # # 当VIP用户访问福利页面时提供更多好的服务
   # if clientIp in VIP_LIST and url=='/myapp/fuli/':
   #   return render(request, 'fuli.html', context={'imgpath': 'meinv1.jpg'})
   # 福利页必须登录了才能查看
   if url == '/myapp/fuli/' and not request.session.get('uname', None):
     return redirect(reverse('myapp:login'))
 # 下钩子于所有路由请求被交给视图函数之前
 def process_view(self, request, view_func, view_args, view_kwargs):
   print(">>> process_view", request, view_func, view_args, view_kwargs)
 # 理论上下钩子于所有路由请求的模板被渲染完成以后
 # 这个函数实测无法回调
 def process_template_response(self, request, response):
   print(">>>>>>>>>> process_template_response", request, response)
   return response
 # 下钩子于所有路由的响应被返回之前
 def process_response(self, request, response):
   print(">>>>>>>>>> process_response", request, response)
   return response
 def process_exception(self, request, exception):
   print(">>>>>>>>>> process_exception", request, exception)
   return redirect('/')

自定义中间件开发流程

3、自定义中间件

  • 用途
    • 统计
    • 黑名单
    • 白名单
    • 反爬(redis)
    • 界面友好化(捕获异常)
  • 流程
    • 在工程目录下创建middleware目录

​

  • 继承MiddleWareMixin

自定义中间件代码结构


class LearnAOP(MiddlewareMixin):
  def process_request(self,request):
    print('request的路径',request.GET.path)

  • 覆写切点方法,实现自己的功能
  • 如果我们逻辑中没有返回值,那么程序执行的时候会按照原有逻辑执行
  • 如果我们做出了返回,那么程序将会从切点处切开,直接回到浏览器
  • 在settings中进行注册

中间件注册配置


MIDDLEWARE = [
  ...
  # 注册自定义的中间件
  'middleware.MyMiddleware.MyappMiddleware',
  ...
]

希望本文所述对大家基于Django框架的Python程序设计有所帮助。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。