Middleware của Express hoạt động như thế nào?

Question

Accepted Answer

**Middleware** là các hàm chạy **theo trình tự** trong chu trình request-response của Express. Mỗi hàm nhận `(req, res, next)` và có thể kiểm tra/sửa request và response, kết thúc response, hoặc gọi `next()` để chuyển quyền điều khiển sang middleware kế tiếp. Chúng là cốt lõi cách các ứng dụng Express được cấu trúc.

## Chữ ký và chuỗi

```js
app.use((req, res, next) => {
  console.log(`${req.method} ${req.url}`); // làm gì đó
  next();                                   // ⬅ chuyển quyền sang middleware kế tiếp
});
```

Quy tắc then chốt: **gọi `next()`** để tiếp tục chuỗi. Quên nó (và không gửi response) thì request treo mãi.

## Luồng chạy

```text
Request → [logger] → [auth] → [body parser] → [route handler] → Response
            next()    next()     next()         res.send()
Mỗi middleware chạy theo thứ tự; bất kỳ cái nào cũng có thể ngắt mạch bằng cách gửi response.
```

## Các loại middleware thường gặp

```js
// 1. Cấp ứng dụng — chạy cho mọi request (hoặc theo path khớp)
app.use(express.json());                       // tích hợp: parse body JSON
app.use(cors());                                // bên thứ ba

// 2. Tùy biến — vd xác thực có thể NGẮT MẠCH
function requireAuth(req, res, next) {
  if (!req.headers.authorization) {
    return res.status(401).json({ error: "Unauthorized" }); // DỪNG — không gọi next()
  }
  req.user = decodeToken(req.headers.authorization);  // gắn dữ liệu cho handler sau
  next();                                              // đã xác thực → tiếp tục
}

// 3. Theo route cụ thể
app.get("/profile", requireAuth, (req, res) => res.json(req.user));
```

Middleware có thể **ngắt mạch** (gửi response và không gọi `next()`, vd chặn request chưa xác thực) hoặc **làm giàu** request (gắn `req.user` cho các handler phía sau).

## Middleware xử lý lỗi (bốn tham số)

```js
// chữ ký đặc biệt với 4 tham số → Express coi đây là error handler
app.use((err, req, res, next) => {
  console.error(err);
  res.status(500).json({ error: "Server error" });
});
// được kích hoạt bởi next(err) hoặc một lỗi được ném; đặt nó CUỐI CÙNG
```

Một error handler có **bốn** tham số (`err` đầu tiên). Bạn đến nó bằng cách gọi `next(err)`; nên đăng ký cuối cùng.

## Thứ tự quan trọng

```text
Middleware chạy theo THỨ TỰ bạn đăng ký. Body parser trước các route đọc body;
auth trước các route được bảo vệ; error handler cuối cùng.
```

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

Middleware là xương sống kiến trúc của Express (và các framework tương tự) — xác thực, log, parse body, CORS, validation và xử lý lỗi đều là middleware.

Hiểu hợp đồng `(req, res, next)` (đặc biệt là phải gọi `next()` hoặc gửi response), cách middleware ngắt mạch hoặc làm giàu request, error handler bốn tham số, và việc **thứ tự quan trọng** là thiết yếu để xây, cấu trúc và debug bất kỳ ứng dụng Express nào.