Middleware của Next.js dùng để làm gì?

Question

Accepted Answer

**Middleware** là code chạy **trước khi một request hoàn tất** — trên Edge, trước khi page hay route handler render. Nó cho phép bạn kiểm tra và rewrite/redirect request, đặt header, hoặc kiểm tra auth cho nhiều route ở một nơi.

## Định nghĩa middleware

```ts
// middleware.ts (ở root của project)
import { NextRequest, NextResponse } from "next/server";

export function middleware(req: NextRequest) {
  const token = req.cookies.get("session")?.value;

// bảo vệ /dashboard — redirect user chưa xác thực tới login
  if (req.nextUrl.pathname.startsWith("/dashboard") && !token) {
    return NextResponse.redirect(new URL("/login", req.url));
  }
  return NextResponse.next(); // cho request tiếp tục
}

// chỉ chạy trên các path này (hiệu năng — đừng chạy trên mọi asset)
export const config = { matcher: ["/dashboard/:path*", "/account/:path*"] };
```

## Middleware có thể làm gì

```ts
NextResponse.redirect(url);          // gửi user đi nơi khác (auth gates)
NextResponse.rewrite(url);           // phục vụ nội dung khác, URL không đổi (A/B, i18n)
NextResponse.next();                  // tiếp tục, có thể kèm header đã chỉnh
// req.geo / req.cookies / req.headers — kiểm tra vị trí, auth, v.v.
```

Các công dụng phổ biến: **chặn theo xác thực**, **redirect** (theo locale/geo, www→apex), **A/B testing** qua rewrite, đặt **security header**, và bot/feature flag.

## Các ràng buộc then chốt

```text
⚠️ Chạy trên EDGE runtime → không có Node.js API (không fs, thư viện hạn chế)
⚠️ Phải NHANH — nó chạy trước mỗi request được khớp; việc nặng làm tăng latency
⚠️ Không thể truy cập database trực tiếp cho auth phức tạp — làm kiểm tra nhẹ
   (ví dụ xác minh một JWT/cookie tồn tại); làm auth đầy đủ trong page/handler
```

Cấu hình `matcher` rất quan trọng: giới hạn middleware chỉ ở các route cần nó, để nó không chạy trên static asset và làm chậm mọi thứ.

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

Middleware là điểm nghẽn duy nhất cho logic request xuyên suốt — auth redirect, định tuyến locale, rewrite và header — áp dụng trên nhiều route mà không lặp code trong từng page.

Biết các ràng buộc Edge của nó (nhanh, không Node API, chỉ kiểm tra nhẹ) và việc giới hạn bằng `matcher` là điều cho phép bạn dùng nó đúng cho các vấn đề gatekeeping và routing.