Django에서 middleware란 무엇인가요?

Question

Accepted Answer

**middleware**는 **모든 요청과 응답**을 전역적으로 처리하는 훅 프레임워크로, 웹 서버와 view 사이에 위치합니다. 각 middleware는 들어오는 요청을 검사/수정하고 나가는 응답을 검사/수정할 수 있습니다. 인증, 보안 헤더, 세션, 로깅 같은 횡단 관심사에 이상적입니다.

## middleware를 통한 요청/응답 흐름

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

middleware는 양파 껍질처럼 view를 감쌉니다:
  - 들어올 때(요청): 위에서 아래로
  - 나갈 때(응답): 아래에서 위로(역순)
```

## Django의 내장 middleware(settings.py에서)

```python
MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",          # 보안 헤더(HSTS 등)
    "django.contrib.sessions.middleware.SessionMiddleware",   # request.session 활성화
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",              # CSRF 방어
    "django.contrib.auth.middleware.AuthenticationMiddleware",# request.user 활성화
    "django.middleware.clickjacking.XFrameOptionsMiddleware", # 클릭재킹 방어
]
# 순서가 중요 — 예: SessionMiddleware는 AuthenticationMiddleware보다 먼저 와야 함
```

Django의 핵심 기능 상당수가 middleware입니다: 세션(`request.session`), 인증(`request.user`), CSRF 방어, 보안 헤더가 모두 내장 middleware에서 나옵니다. **순서가 중요**합니다. 일부 middleware는 다른 것이 먼저 실행되는 데 의존합니다.

## 커스텀 middleware 작성하기

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

def __call__(self, request):
        # --- 여기 코드는 들어올 때(view 이전) 실행됨 ---
        import time; start = time.time()

response = self.get_response(request)     # 다음 계층 호출(결국 view)

# --- 여기 코드는 나갈 때(view 이후) 실행됨 ---
        response["X-Response-Time"] = f"{time.time() - start:.3f}s"
        return response
```

middleware는 호출 가능(callable) 객체입니다: `self.get_response(request)` 이전의 코드는 요청에서 실행되고, 이후의 코드는 응답에서 실행됩니다. 이로써 view 실행 전후에 모두 작동할 수 있습니다.

## 흔한 middleware 용도

```text
✓ 인증 / request.user 설정
✓ 보안 헤더(CSP, HSTS, X-Frame-Options)
✓ 요청/응답 로깅, 타이밍, 메트릭
✓ 세션, 로케일/i18n 감지, CORS
✓ 속도 제한, 점검 모드, 커스텀 요청 전처리
```

## middleware vs view/데코레이터

```text
middleware → 모든(또는 대부분) 요청에 영향을 주는 전역 횡단 관심사
데코레이터/view 로직 → 특정 엔드포인트에 한정된 view별 관심사
→ 앱 전반 동작에는 middleware; 선택적 동작에는 데코레이터 사용.
```

## 왜 중요한가

middleware는 Django가 요청을 처리하는 방식의 근본입니다. 이를 이해하면 프레임워크의 핵심 기능 상당수가 실제로 어떻게 동작하는지 설명되고, **전역 횡단 관심사**에 적합한 메커니즘을 제공받습니다.

세션, 인증(`request.user`), CSRF 방어, 보안 헤더가 모두 내장 middleware에서 나온다는 점을 인식하면 Django의 요청 처리가 명확해지고 이러한 기능이 왜 "그냥 동작하는지" 알게 됩니다. **양파 껍질 요청/응답 흐름**(middleware가 view를 감싸 요청은 위에서 아래로, 응답은 아래에서 위로 처리)과 **순서가 중요하다**(일부 middleware는 다른 것에 의존, 인증이 세션을 먼저 필요로 하는 것처럼)는 점을 이해하는 것은 Django를 올바르게 구성하고 문제를 디버깅하는 데 중요합니다.

**커스텀 middleware를 작성**하는 능력은 앱 전반 동작(로깅, 타이밍, 커스텀 헤더, 속도 제한, 점검 모드)을 view 전반에 반복하지 않고 한 곳에서 깔끔하게 구현하는 데 가치가 있습니다.

middleware(대부분의 요청에 영향을 주는 전역 관심사)와 데코레이터나 view 로직(엔드포인트별 관심사)을 언제 사용할지 아는 것은 핵심적인 아키텍처 결정입니다.

middleware는 Django가 애플리케이션 전체에 적용되는 요청/응답 처리를 다루는 곳으로, 프레임워크의 내부를 이해하고 횡단 관심사를 적절히 분리하여 잘 구조화된 애플리케이션을 구축하는 데 중요하고 실용적으로 관련된 지식입니다.