django 2.0+ 中间件必须是可调用对象,推荐实现 __call__ 方法并接收 get_response 参数;需在请求阶段校验、响应阶段返回 response;顺序影响执行流;异步视图需匹配异步中间件。

Middleware类必须继承django.utils.decorator.decorator或直接实现__call__
Django 2.0+ 要求中间件是可调用对象,最稳妥写法是定义一个类并实现 __call__ 方法。老式基于函数的写法(process_request 等钩子)在新版本里仍能工作,但已不推荐——它依赖 Django 内部的兼容层,行为边界模糊,调试时容易漏掉执行时机。
- 类中间件更清晰:每个请求/响应都走同一入口
__call__,逻辑收束,也方便加日志或异常捕获 - 必须带
get_response参数:这是链式调用的关键,你不调用它,后续中间件和视图就全卡住 - 别忘了返回值:
__call__必须返回response对象,否则 Django 报ValueError: The view must return an HttpResponse
class LogIPMiddleware:
def __init__(self, get_response):
self.get_response = get_response
<pre class="brush:python;toolbar:false;">def __call__(self, request):
print(f"IP: {request.META.get('REMOTE_ADDR')}")
response = self.get_response(request) # ⚠️ 必须调用
return response # ⚠️ 必须返回
拦截请求前做权限/参数校验,别在响应阶段改 request
request 对象在进入中间件链后是只读的(严格说,是“不应被修改”的)。你在响应阶段试图改 request.user 或 request.GET,不会影响已执行过的视图逻辑,纯属白忙活。
- 校验类操作(如 token 验证、IP 黑名单)务必放在
__call__开头,失败就直接return HttpResponseForbidden() - 想给视图传额外数据?用
request.xxx = value是安全的,Django 不禁止,但要确保 key 名不冲突(比如别叫request.user) - 如果需要动态修改查询参数再进视图,得在
get_response调用前重建request.GET(用QueryDict.copy()),但这类需求通常说明设计有歧义,优先考虑路由或视图层处理
MIDDLEWARE 配置顺序决定执行流向,靠前的先拦截请求、后处理响应
Django 中间件按 MIDDLEWARE 列表从上到下执行请求,再从下到上返回响应。这个“倒序返回”特性常被误读——比如你把日志中间件放最底下,它确实最后收到请求,但最先拿到响应,容易误以为“它在结尾才起作用”。
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
-
SecurityMiddleware必须靠前:它要尽早设置 header、拦截恶意 host,放太后面就失效 -
AuthenticationMiddleware要在SessionMiddleware之后:因为request.user依赖 session 数据 - 自定义中间件若依赖用户信息,就得放在
AuthenticationMiddleware后;若只想拦未登录访问,放它前面反而更快失败 - 调试时可在每个中间件加
print("in X")和print("out X"),看输出顺序就能验证流向
异步视图下中间件必须显式声明 async,否则报 RuntimeError
如果你的视图用了 async def,而中间件还是同步写法,Django 运行时会抛 RuntimeError: Expected a synchronous response but got an awaitable——这不是配置问题,是类型不匹配。
- 同步中间件不能处理 async 视图,反之亦然;二者不能混用
- 要支持 async,中间件类得加
__aiter__或直接写成异步__call__(Django 4.1+ 支持) - 更稳的做法:用
sync_to_async包装耗时同步操作(如数据库查用户),但别包装整个get_response调用 - 注意
request.body在异步中间件里需用await request.body读取,直接 .read() 会出错
中间件不是万能钩子,它的生命周期绑定在单次请求响应流里;跨请求状态得靠 cache 或数据库,别试图在中间件实例里存东西——每次请求都是新实例。










