Что такое middleware в Django?

Question

Accepted Answer

**Middleware** — это набор хуков, которые обрабатывают **каждый запрос и ответ** глобально, располагаясь между веб-сервером и вашими views. Каждый middleware может проверять/изменять запросы при входе и ответы при выходе — идеально подходит для сквозных функциональностей, таких как аутентификация, заголовки безопасности, сессии и логирование.

## Поток запроса/ответа через middleware

```text
Request  → MW1 → MW2 → MW3 → VIEW
Response ← MW1 ← MW2 ← MW3 ← VIEW

Middleware wraps the view like layers of an onion:
  - on the way IN (request): top-to-bottom
  - on the way OUT (response): bottom-to-top (reverse order)
```

## Встроенные middleware Django (в settings.py)

```python
MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",          # security headers (HSTS, etc.)
    "django.contrib.sessions.middleware.SessionMiddleware",   # enables request.session
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",              # CSRF protection
    "django.contrib.auth.middleware.AuthenticationMiddleware",# enables request.user
    "django.middleware.clickjacking.XFrameOptionsMiddleware", # clickjacking protection
]
# ORDER MATTERS — e.g. SessionMiddleware must come before AuthenticationMiddleware
```

Большая часть основной функциональности Django — это middleware: сессии (`request.session`), аутентификация (`request.user`), защита от CSRF и заголовки безопасности — всё поступает из встроенного middleware. **Порядок имеет значение** — некоторый middleware зависит от того, что другие запустились первыми.

## Написание пользовательского middleware

```python
class TimingMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response          # the next middleware/view

def __call__(self, request):
        # --- code here runs on the way IN (before the view) ---
        import time; start = time.time()

response = self.get_response(request)     # call the next layer (eventually the view)

# --- code here runs on the way OUT (after the view) ---
        response["X-Response-Time"] = f"{time.time() - start:.3f}s"
        return response
```

Middleware — это callable: код перед `self.get_response(request)` выполняется на запросе, код после выполняется на ответе. Это позволяет вам действовать как до, так и после выполнения view.

## Основные применения middleware

```text
✓ Authentication / setting request.user
✓ Security headers (CSP, HSTS, X-Frame-Options)
✓ Request/response logging, timing, metrics
✓ Sessions, locale/i18n detection, CORS
✓ Rate limiting, maintenance mode, custom request preprocessing
```

## Middleware vs views/decorators

```text
Middleware → GLOBAL, cross-cutting concerns affecting EVERY (or most) request
Decorators/view logic → per-view concerns specific to certain endpoints
→ Use middleware for app-wide behavior; decorators for selective behavior.
```

## Почему это важно

Middleware — это фундамент того, как Django обрабатывает запросы — понимание его объясняет, как большая часть основной функциональности фреймворка работает на самом деле и предоставляет правильный механизм для **глобальных, сквозных функциональностей**.

Осознание того, что сессии, аутентификация (`request.user`), защита от CSRF и заголовки безопасности все поступают из встроенного middleware, разъясняет обработку запросов Django и показывает, почему эти функции "просто работают". Понимание **слоистого потока запроса/ответа** (middleware обёртывает view, обрабатывая запросы сверху вниз и ответы снизу вверх) и того, что **порядок имеет значение** (некоторый middleware зависит от других, например аутентификация нуждается в сессиях в первую очередь), важно для правильной настройки Django и отладки проблем.

Возможность **писать пользовательский middleware** ценна для реализации поведения на уровне приложения чисто — логирование, таймирование, пользовательские заголовки, ограничение скорости, режим обслуживания — в одном месте, а не повторяя это во всех views.

Знание того, когда использовать middleware (глобальные функциональности, затрагивающие большинство запросов) в сравнении с decorators или logic на уровне view (функциональности для конкретного endpoint), — это ключевое архитектурное решение.

Middleware — это место, где Django обрабатывает запрос/ответ, который применяется ко всему приложению, делая это важным, практически релевантным знанием как для понимания внутренних механизмов фреймворка, так и для построения хорошо структурированных приложений с надлежащим разделением сквозных функциональностей.