Fullstack Node.js & React
Trang chủ / Module 12
▲ Module 12 / 19 · 5 ngày 📅 Tuần 9 ●●●○ Khó

Next.js App Router: Server Components, Server Actions, caching, SEO

Framework fullstack React phổ biến nhất: Server vs Client Components, data fetching trên server, Server Actions, các tầng cache và revalidation, streaming với Suspense, route handlers, proxy/middleware, metadata và SEO.

App RouterRSCServer ActionsCachingStreamingSEO
📌 Vì sao module này quan trọng

Next.js gần như là yêu cầu mặc định trong JD React năm 2026. Nhưng App Router đổi hẳn mô hình tư duy: code chạy ở đâu (server hay trình duyệt), dữ liệu được cache ở tầng nào, khi nào trang static khi nào dynamic. Người không nắm chắc sẽ vô tình rò secret xuống client, gửi bundle 500KB, hoặc hiển thị dữ liệu cũ mà không hiểu vì sao. Đây là module Khó vì phải nắm đồng thời React, HTTP caching và kiến trúc server.

🎯 Mục tiêu học tập

  • Phân biệt Server Component và Client Component; đặt ranh giới 'use client' đúng chỗ
  • Fetch dữ liệu trên server, song song, có streaming với Suspense và loading.tsx
  • Dùng Server Actions cho mutation, có validate và kiểm tra quyền
  • Hiểu các tầng cache và cách revalidate theo path/tag
  • Làm route handler, proxy/middleware, metadata, SEO và chọn cách render phù hợp

Server Components vs Client Components

Server Component (mặc định)Client Component ('use client')
Chạy ởServer (lúc build hoặc request)Server (SSR lần đầu) + trình duyệt (hydrate)
Đượcasync/await, truy cập DB, đọc secret, thư viện nặng không vào bundleState, effect, event handler, API trình duyệt
Không đượcuseState, onClick, windowTruy cập DB/secret trực tiếp
// app/projects/[id]/page.tsx — Server Component
export default async function ProjectPage({ params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const user = await requireUser();                       // đọc cookie trên server
  const [project, tasks] = await Promise.all([getProject(id, user), getTasks(id, user)]); // song song
  return (
    <>
      <ProjectHeader project={project} />                  {/* server */}
      <TaskBoard initialTasks={tasks} projectId={id} />    {/* 'use client' — có kéo thả */}
    </>
  );
}
  • Đẩy 'use client' xuống lá của cây (nút, form, board) — không đặt ở layout gốc.
  • Props truyền từ server xuống client phải serialize được (không truyền hàm, class instance).
  • Dùng package server-only trong file truy cập DB để import nhầm vào client là lỗi build.

Streaming, Suspense, loading và error

app/projects/[id]/
├── layout.tsx       # giữ nguyên khi chuyển trang con
├── page.tsx
├── loading.tsx      # tự bọc page trong Suspense
├── error.tsx        # 'use client' — error boundary cho segment
└── not-found.tsx

// Phần chậm stream sau, phần nhanh hiện ngay
<Suspense fallback={<ChartSkeleton />}>
  <AnalyticsChart projectId={id} />   {/* async component gọi query nặng */}
</Suspense>

Tránh waterfall: component cha await xong mới render con, con lại await tiếp. Khởi động các promise sớm và song song, hoặc tách thành các vùng Suspense độc lập.

Server Actions cho mutation

// app/projects/actions.ts
'use server';
export async function createTask(_prev: ActionState, formData: FormData): Promise<ActionState> {
  const user = await requireUser();                                  // Server Action là endpoint công khai!
  const parsed = CreateTaskSchema.safeParse(Object.fromEntries(formData));
  if (!parsed.success) return { ok: false, errors: z.flattenError(parsed.error).fieldErrors };
  await assertCan(user, 'task:create', parsed.data.projectId);       // kiểm tra quyền
  await db.task.create({ data: { ...parsed.data, orgId: user.orgId } });
  revalidatePath(`/projects/${parsed.data.projectId}`);              // hoặc revalidateTag/updateTag
  return { ok: true };
}
⚠️ Server Action = API endpoint

Ai cũng có thể gọi nó bằng một request POST. Luôn xác thực, kiểm tra quyền và validate input như một route API bình thường. Đừng tin tham số chỉ vì nó "đến từ form của mình".

Caching và revalidation

Caching là phần thay đổi nhiều nhất giữa các phiên bản Next.js (15 chuyển nhiều thứ sang "không cache mặc định"; 16 đưa ra Cache Components với directive 'use cache', cacheLife, cacheTag). Luôn đối chiếu tài liệu của đúng phiên bản bạn dùng. Các khái niệm nền thì ổn định:

TầngCái gìVô hiệu hoá
Data cacheKết quả fetch / hàm được đánh dấu cache trên serverrevalidateTag, revalidatePath, thời gian
Full route cacheHTML + RSC payload của route staticRevalidate, hoặc route dùng dữ liệu động (cookies, headers)
Router cache (client)RSC payload các trang đã xemrouter.refresh(), Server Action revalidate
CDNResponse staticTheo header / deploy
// Next 16 (Cache Components)
async function getPricingPlans() {
  'use cache';
  cacheLife('hours');
  cacheTag('pricing');
  return db.plan.findMany();
}
// sau khi admin sửa giá: revalidateTag('pricing') / updateTag('pricing')

Cách chọn render: trang marketing/blog → static (+ revalidate); dashboard theo người dùng → dynamic; trang sản phẩm → static phần khung + stream phần động (Partial Prerendering).

Route handlers, proxy/middleware, SEO, deploy

  • Route handlers (app/api/.../route.ts) cho webhook, endpoint cho mobile/bên thứ ba, file download. Với backend NestJS riêng, Next.js gọi tới nó từ Server Component (truyền cookie/token) — kiến trúc "BFF".
  • Proxy (trước đây gọi là middleware, đổi tên thành proxy.ts ở Next 16): chạy trước mọi request — redirect chưa đăng nhập, i18n, A/B. Chỉ làm việc nhẹ; kiểm tra quyền thật vẫn ở page/action.
  • SEO: generateMetadata, Open Graph image (opengraph-image.tsx), sitemap.ts, robots.ts, dữ liệu có cấu trúc JSON-LD.
  • next/image, next/font, next/link prefetch — tối ưu sẵn.
  • Deploy: Vercel (dễ nhất), hoặc tự host bằng output: 'standalone' trong Docker (Module 16). Biết những gì cần cấu hình thêm khi tự host (cache handler dùng chung khi nhiều instance, image optimization).

🏋️ Bài tập thực hành

Chuyển frontend sang Next.js với kiến trúc BFF

(1) Port app sang Next.js App Router: trang marketing static, trang pricing cache theo tag, dashboard dynamic. (2) Trang project fetch song song trên server, board là client component nhận dữ liệu ban đầu và hydrate vào TanStack Query. (3) Ít nhất 3 mutation bằng Server Actions có validate + kiểm tra quyền + revalidate. (4) Một vùng analytics chậm stream bằng Suspense. (5) Proxy redirect người chưa đăng nhập. (6) Metadata động, OG image, sitemap. (7) Chạy next build, ghi lại route nào static/dynamic và giải thích vì sao.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Đặt ranh giới 'use client' ở lá, không rò secret xuống client
  • Không có waterfall fetch; vùng chậm được stream
  • Mọi Server Action đều xác thực, kiểm tra quyền, validate
  • Giải thích được route nào static/dynamic và cách revalidate