Django中间件怎么写？自定义拦截请求响应

Django 2.0+ 中间件必须是可调用对象，推荐通过实现 `__call__` 方法的类来编写，它以清晰、可控的方式统一处理请求与响应流程——在调用 `get_response(request)` 前完成权限校验、日志记录或请求预处理，在其后处理响应；顺序至关重要，MIDDLEWARE 列表决定执行链的“先入后出”流向，错位可能导致安全机制失效或用户信息不可用；同时需严格区分同步与异步场景：async 视图必须搭配异步中间件，否则直接报错；而 request 对象仅应在请求阶段修改（如注入数据），响应阶段修改已无意义。掌握这些核心原则，你就能写出健壮、可维护、符合 Django 最佳实践的自定义中间件。

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
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 列表从上到下执行请求，再从下到上返回响应。这个“倒序返回”特性常被误读——比如你把日志中间件放最底下，它确实最后收到请求，但最先拿到响应，容易误以为“它在结尾才起作用”。

• 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 或数据库，别试图在中间件实例里存东西——每次请求都是新实例。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。