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.
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) |
| Được | async/await, truy cập DB, đọc secret, thư viện nặng không vào bundle | State, effect, event handler, API trình duyệt |
| Không được | useState, onClick, window | Truy 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-onlytrong 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 };
}
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ầng | Cái gì | Vô hiệu hoá |
|---|---|---|
| Data cache | Kết quả fetch / hàm được đánh dấu cache trên server | revalidateTag, revalidatePath, thời gian |
| Full route cache | HTML + RSC payload của route static | Revalidate, hoặc route dùng dữ liệu động (cookies, headers) |
| Router cache (client) | RSC payload các trang đã xem | router.refresh(), Server Action revalidate |
| CDN | Response static | Theo 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/linkprefetch — 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
(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
-
Next.js DocsTài liệu chính thức — luôn chọn đúng phiên bảnDocs
-
Next.js LearnKhoá học chính thức xây dashboardKhoá học
-
react.dev — Server ComponentsMô hình RSC từ phía ReactDocs
-
Next.js — CachingCác tầng cache và revalidationDocs
-
Next.js — Data securityBảo vệ Server Actions và dữ liệuDocs
✅ 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