Next.js từ cơ bản đến nâng cao
Trang chủ / Module 14
🔬 Module 14 / 18 · 5 ngày 📅 Tuần 8 ●●●● Cực khó

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.

Flight protocolHydrationEdge vs NodeRequest lifecycle
📌 Vì sao module này quan trọng

Đâ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 I là 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).
  • $L3 là chỗ trống được điền sau khi phần Suspense xong — streaming ở mức dữ liệu.
Bảo mật của chính giao thức

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ânVí dụCách sửa
Giá trị khác nhau giữa server và clientnew 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 rendertypeof 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 DOMGrammarly, dịch trangKhông phải lỗi của bạn; thử ở cửa sổ ẩn danh
Theme/ngôn ngữ đọc từ clientDark mode từ localStorageScript 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
APIToàn bộ Node.js, mọi package npmWeb API (fetch, Request, crypto.subtle); không có fs, nhiều driver DB không chạy
Cold startChậm hơnRất nhanh
Vị tríMột/vài regionGần người dùng — nhưng xa DB thì mỗi query lại chậm
Dùng choHầ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

Mổ xẻ một trang

(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

✅ 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