Middleware trong Django là gì?

Question

Accepted Answer

**Middleware** là một framework gồm các hook xử lý **mọi request và response** một cách toàn cục, nằm giữa web server và các view của bạn. Mỗi middleware có thể kiểm tra/sửa đổi request trên đường vào và response trên đường ra — lý tưởng cho các mối quan tâm xuyên suốt như xác thực, header bảo mật, session, và logging.

## Luồng request/response qua middleware

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

Middleware bọc view như các lớp của một củ hành:
  - trên đường VÀO (request): từ trên xuống dưới
  - trên đường RA (response): từ dưới lên trên (thứ tự ngược)
```

## Middleware tích hợp của Django (trong settings.py)

```python
MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",          # header bảo mật (HSTS, v.v.)
    "django.contrib.sessions.middleware.SessionMiddleware",   # bật request.session
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",              # bảo vệ CSRF
    "django.contrib.auth.middleware.AuthenticationMiddleware",# bật request.user
    "django.middleware.clickjacking.XFrameOptionsMiddleware", # bảo vệ clickjacking
]
# THỨ TỰ QUAN TRỌNG — vd: SessionMiddleware phải đứng trước AuthenticationMiddleware
```

Phần lớn chức năng cốt lõi của Django là middleware: session (`request.session`), xác thực (`request.user`), bảo vệ CSRF, và header bảo mật đều đến từ middleware tích hợp. **Thứ tự quan trọng** — một số middleware phụ thuộc vào việc cái khác chạy trước.

## Viết middleware tùy biến

```python
class TimingMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response          # middleware/view kế tiếp

def __call__(self, request):
        # --- mã ở đây chạy trên đường VÀO (trước view) ---
        import time; start = time.time()

response = self.get_response(request)     # gọi lớp kế tiếp (cuối cùng là view)

# --- mã ở đây chạy trên đường RA (sau view) ---
        response["X-Response-Time"] = f"{time.time() - start:.3f}s"
        return response
```

Một middleware là một callable: mã trước `self.get_response(request)` chạy trên request, mã sau chạy trên response. Điều này cho phép bạn hành động cả trước và sau khi view thực thi.

## Các cách dùng middleware phổ biến

```text
✓ Xác thực / đặt request.user
✓ Header bảo mật (CSP, HSTS, X-Frame-Options)
✓ Logging request/response, đo thời gian, metric
✓ Session, phát hiện locale/i18n, CORS
✓ Giới hạn tốc độ, chế độ bảo trì, tiền xử lý request tùy biến
```

## Middleware so với view/decorator

```text
Middleware → mối quan tâm TOÀN CỤC, xuyên suốt ảnh hưởng tới MỌI (hoặc hầu hết) request
Decorator/logic view → mối quan tâm theo từng view, riêng cho một số endpoint nhất định
→ Dùng middleware cho hành vi toàn ứng dụng; decorator cho hành vi chọn lọc.
```

## Tại sao điều này quan trọng

Middleware là nền tảng cho cách Django xử lý request — hiểu nó giải thích cách phần lớn chức năng cốt lõi của framework thực sự hoạt động và cung cấp cơ chế đúng đắn cho các **mối quan tâm toàn cục, xuyên suốt**.

Nhận ra rằng session, xác thực (`request.user`), bảo vệ CSRF, và header bảo mật đều đến từ middleware tích hợp làm sáng tỏ việc xử lý request của Django và cho thấy vì sao các tính năng này "cứ thế hoạt động".

Hiểu **luồng request/response kiểu củ hành** (middleware bọc view, xử lý request từ trên xuống và response từ dưới lên) và rằng **thứ tự quan trọng** (một số middleware phụ thuộc vào cái khác, như xác thực cần session trước) là quan trọng để cấu hình Django đúng và gỡ lỗi các vấn đề.

Khả năng **viết middleware tùy biến** có giá trị để hiện thực hành vi toàn ứng dụng một cách gọn gàng — logging, đo thời gian, header tùy biến, giới hạn tốc độ, chế độ bảo trì — ở một chỗ thay vì lặp lại nó khắp các view.

Biết khi nào dùng middleware (mối quan tâm toàn cục ảnh hưởng tới hầu hết request) so với decorator hoặc logic view (mối quan tâm theo từng endpoint) là một quyết định kiến trúc then chốt.

Middleware là nơi Django xử lý request/response áp dụng xuyên toàn ứng dụng, khiến nó trở thành kiến thức quan trọng, thực tế cả để hiểu nội bộ framework lẫn để xây dựng các ứng dụng có cấu trúc tốt với sự tách biệt đúng đắn các mối quan tâm xuyên suốt.