Bên trong: RSC payload, SSR, hydration và runtime
Một request đi qua Next.js thế nào, RSC payload (Flight) chứa gì, SSR và hydration khác nhau ra sao, sửa lỗi hydration mismatch, selective hydration, và Node.js runtime so với Edge runtime.
Đây là phần khó nhất về mặt khái niệm: hai loại "server rendering" (RSC và SSR) cùng tồn tại, hai lần render của Client Component, và một định dạng dữ liệu riêng chạy giữa server và client. Hiểu nó thì debug được lỗi hydration, giải thích được vì sao một prop làm lộ dữ liệu, và trả lời được những câu hỏi phỏng vấn sâu nhất về Next.js.
🎯 Mục tiêu học tập
- Mô tả vòng đời một request từ proxy tới HTML cuối cùng
- Phân biệt RSC (render Server Component ra payload) và SSR (render ra HTML)
- Đọc được RSC payload trong tab Network
- Hiểu hydration, nguyên nhân mismatch và cách sửa
- Hiểu streaming SSR + selective hydration
- Chọn đúng Node.js runtime hay Edge runtime
Vòng đời một request (lần tải đầu)
Trình duyệt ── GET /products/ao-thun ──►
1. proxy.ts (redirect/rewrite/header)
2. Router khớp segment: layout gốc → layout products → page
3. Có bản prerender (static shell)? → gửi ngay phần đó
4. RSC render: chạy Server Components (await dữ liệu), gặp Client Component thì
ghi "tham chiếu tới module client + props" thay vì chạy nó
──► kết quả: RSC payload (Flight)
5. SSR: dùng RSC payload + chạy Client Components trên server (react-dom/server)
──► HTML
6. Stream HTML (shell trước, từng Suspense boundary sau) + nhúng RSC payload vào <script>
Trình duyệt:
7. Hiển thị HTML ngay (chưa tương tác được)
8. Tải JS của Client Components
9. Hydrate: React dựng lại cây từ RSC payload, gắn event handler vào DOM có sẵn
Điều hướng mềm lần sau: chỉ tải RSC payload (?_rsc=…), không cần HTML.
Hai khái niệm hay nhầm: RSC chạy Server Components ra payload (Server Components không bao giờ chạy ở client). SSR biến cả cây (gồm Client Components) thành HTML cho lần tải đầu. Client Component được "render" hai nơi: một lần ra HTML trên server, một lần khi hydrate trên trình duyệt.
RSC payload trông như thế nào
Mở DevTools → Network → điều hướng mềm → request có ?_rsc= (header RSC: 1). Nội dung (rút gọn, định dạng thay đổi theo phiên bản):
1:I["(app-pages-browser)/./app/_components/AddToCart.tsx",["chunks/123.js"],"AddToCart"]
2:"$Sreact.suspense"
0:["$","main",null,{"children":[
["$","h1",null,{"children":"Áo thun"}],
["$","$L1",null,{"productId":"p1","price":199000}],
["$","$2",null,{"fallback":["$","p",null,{"children":"Đang tải…"}],"children":"$L3"}]
]}]
3:["$","ul",null,{"children":[ ... đánh giá stream tới sau ... ]}]
- Dòng
Ilà tham chiếu tới module Client Component (chunk JS cần tải) — đây là cách server "nhường chỗ" cho client. - Props của Client Component nằm nguyên văn trong payload → mọi thứ bạn truyền xuống đều công khai (Module 4, 16).
$L3là chỗ trống được điền sau khi phần Suspense xong — streaming ở mức dữ liệu.
Payload cũng chạy theo chiều ngược lại khi client gọi Server Function. Tháng 12/2025, lỗ hổng CVE-2025-55182 trong phần giải mã Flight của React Server Components cho phép thực thi mã từ xa trên server chưa vá — ảnh hưởng mọi framework dùng RSC, kể cả Next.js. Việc cập nhật bản vá React/Next.js kịp thời là một phần của vận hành (Module 16).
Hydration và lỗi mismatch
Hydration yêu cầu cây React ở client khớp với HTML server đã gửi. Lệch → React cảnh báo, có thể render lại cả phần đó ở client (mất lợi ích SSR, nháy giao diện).
| Nguyên nhân | Ví dụ | Cách sửa |
|---|---|---|
| Giá trị khác nhau giữa server và client | new Date().toLocaleTimeString(), Math.random(), múi giờ | Tính ở server rồi truyền xuống; hoặc hiển thị sau khi mount |
| Đọc browser API khi render | typeof window !== 'undefined' ? A : B, localStorage | Đọc trong effect hoặc useSyncExternalStore có getServerSnapshot |
| HTML không hợp lệ | <div> trong <p>, <a> lồng <a>, <tr> thiếu <tbody> | Sửa cấu trúc |
| Extension trình duyệt sửa DOM | Grammarly, dịch trang | Không phải lỗi của bạn; thử ở cửa sổ ẩn danh |
| Theme/ngôn ngữ đọc từ client | Dark mode từ localStorage | Script chặn trong <head> đặt class trước khi vẽ (next-themes), suppressHydrationWarning trên <html> |
'use client';
function LocalTime({ iso }: { iso: string }) {
const [text, setText] = useState<string | null>(null);
useEffect(() => setText(new Date(iso).toLocaleTimeString('vi-VN')), [iso]);
return <time dateTime={iso}>{text ?? '—'}</time>; // server và lần render đầu ở client giống nhau
}
suppressHydrationWarning chỉ tắt cảnh báo cho một cấp thuộc tính/text — dùng cho trường hợp chủ đích như timestamp, không
dùng để che bug.
Streaming SSR và selective hydration
- Mỗi Suspense boundary là một đơn vị stream và một đơn vị hydrate. React không cần đợi toàn bộ JS mới hydrate: phần nào có code và dữ liệu thì hydrate trước.
- Người dùng click vào phần chưa hydrate → React ưu tiên hydrate phần đó trước (ghi lại sự kiện và phát lại).
- Hệ quả thiết kế: bọc phần nặng (comment, widget) trong Suspense không chỉ giúp hiển thị nhanh mà còn giúp trang tương tác sớm hơn.
Node.js runtime và Edge runtime
| Node.js runtime (mặc định) | Edge runtime | |
|---|---|---|
| API | Toàn bộ Node.js, mọi package npm | Web API (fetch, Request, crypto.subtle); không có fs, nhiều driver DB không chạy |
| Cold start | Chậm hơn | Rất nhanh |
| Vị trí | Một/vài region | Gần người dùng — nhưng xa DB thì mỗi query lại chậm |
| Dùng cho | Hầu hết mọi thứ | Logic nhẹ không cần DB gần (redirect, A/B, OG image) |
export const runtime = 'edge'; // trong page/route handler (không áp dụng cho proxy ở Next.js 16 — proxy chạy Node.js)
Xu hướng gần đây là quay về Node.js runtime cho phần lớn công việc (Next.js 16 đặt proxy chạy trên Node.js), vì dữ liệu nằm ở một region và hệ sinh thái npm đầy đủ quan trọng hơn vài chục ms cold start.
🚩 Sai lầm hay gặp
- Nghĩ Client Component chỉ chạy ở trình duyệt.
- Dùng
suppressHydrationWarningđể che lỗi. - Chuyển sang Edge vì 'nhanh hơn' trong khi DB ở một region.
🏋️ Bài tập thực hành
(1) Lưu RSC payload của một trang có Client Component và Suspense, chú thích từng dòng. (2) Cố tình tạo 4 loại hydration mismatch (Date, window, <div> trong <p>, theme) rồi sửa từng cái. (3) Viết một trang dài 1 trang A4 giải thích vòng đời request như đang trả lời phỏng vấn.
📚 Tài nguyên học tập
- Docs
-
Dan Abramov — RSC from scratchTự dựng RSC từ đầuArticle
-
Next.js — Edge and Node.js RuntimesGiới hạn EdgeDocs
✅ Tự đánh giá hoàn thành
- Tôi mô tả được vòng đời request trong 2 phút
- Tôi phân biệt được RSC và SSR
- Tôi đọc được RSC payload và chỉ ra props của Client Component
- Tôi sửa được 4 loại hydration mismatch
- Tôi chọn đúng runtime