Django 自定义中间件:原理、实现与执行顺序详解

Miles
Miles
发布时间:2026-10-13| 5人浏览过
原创

本文详解 Django 中如何创建自定义中间件。通过继承 MiddlewareMixin 实现 process_request 和 process_response 方法,控制请求与响应流程。重点解析 MIDDLEWARE 配置列表中中间件的注册顺序,阐明多个中间件在视图执行前后的执行逻辑与顺序差异。

中间件基本概念

中间件是什么?

中间件的作用机制类似于 Flask 中的钩子函数,允许在请求到达视图函数之前或视图函数返回响应之后执行特定逻辑。关键特性在于,中间件对 Django 项目中的所有视图均生效。

通常,自定义中间件需包含两个核心方法:process_request 和 process_response。前者用于处理请求抵达视图函数前的逻辑,后者用于处理视图函数执行完毕后的逻辑。

自定义中间件实现

编写一个自定义的中间件

根据具体业务需求,开发者可以自行编写中间件。在动手编码前,建议阅读 的源码,以理解 Django 提供的中间件基类机制。


class MiddlewareMixin(object):
  def __init__(self, get_response=None):
    self.get_response = get_response
    super(MiddlewareMixin, self).__init__()

  def __call__(self, request):
    response = None
    if hasattr(self, 'process_request'):
      response = self.process_request(request)
    if not response:
      response = self.get_response(request)
    if hasattr(self, 'process_response'):
      response = self.process_response(request, response)
    return response

方法名 作用 返回值 备注
__init__(self, get_response=None) 服务器启动(重启)时执行一次 无 --
process_request(self, request) 在视图执行之前调用
  • 返回 `None`: 会执行视图
  • 返回 `HttpResponse`: 不会再执行视图
--
process_response(self, request, response) 在视图执行完之后调用 必须返回HttpResponse对象 --

编写自定义的中间件:


class My_middleware(MiddlewareMixin):
  def __init__(self,get_response=None):
    super().__init__(get_response)

  def process_request(self,request):
    """
    视图函数前执行的,一旦这里有return将到达不了视图函数
    request是浏览器发过来的请求
    """
    print("视图函数执行前")

  def process_response(self,request,response):
    """
    视图函数后执行的
    request是浏览器发过来的请求
    response是视图函数返回的响应
    """
    print("视图函数执行后")

    # 因为你拿了视图函数的response,就算处理的业务与response无关也要返回response
    return response

中间件注册与配置

中间件的注册


MIDDLEWARE = [
  ...
  'middlewares.My_middleware'  # 写上自己的路径
]

多中间件执行顺序解析

多个中间件的执行顺序

!!!如果你定义了多个中间件,记得注意一下中间件摆在setting.py文件的位置:

  • 注册中间件设置是由上到下执行的,所以上面的中间件会先被注册
  • 对于视图函数执行前的process_request,先注册的中间件会先执行
  • 对于视图函数执行后的process_response,后注册的中间件会先执行

例如:

先注册中间件1,后注册中间件2。

输出结果是:


before 视图(中间件1)
before 视图 2(中间件2)
==index==
after 视图 2(中间件2)
after 视图(中间件1)

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

相关标签:

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

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 算法库。