Next.js từ cơ bản đến nâng cao
Trang chủ / Module 5
📡 Module 5 / 18 · 4 ngày 📅 Tuần 3 ●●○○ Trung bình

Data fetching trong Server Component và streaming

Fetch dữ liệu ngay trong Server Component, tránh waterfall bằng chạy song song và preload, request memoization với cache(), streaming bằng loading.tsx và Suspense, truyền Promise xuống Client Component.

async componentWaterfallSuspenseReact cache()
📌 Vì sao module này quan trọng

Server Component cho phép viết await db.query() ngay trong component — rất tiện, nhưng cũng rất dễ tạo waterfall: ba await nối tiếp nhau là ba lần chờ. Streaming là công cụ để trang hiện nhanh dù có phần chậm. Hai thứ này quyết định tốc độ thật của ứng dụng Next.js.

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

  • Fetch dữ liệu trong Server Component bằng fetch, ORM hoặc SDK
  • Nhận ra và loại bỏ waterfall bằng Promise.all và tách component
  • Dùng cache() của React để dùng chung kết quả trong một request
  • Stream từng phần trang bằng loading.tsx và <Suspense>
  • Truyền Promise từ server xuống client và đọc bằng use()

Fetch ngay trong component

// app/products/[id]/page.tsx
export default async function ProductPage({ params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const product = await db.query.products.findFirst({ where: eq(products.id, id) });
  if (!product) notFound();
  return <ProductView product={product} />;
}

Không cần useEffect, không cần API trung gian, không có trạng thái loading ở client. Đừng gọi Route Handler của chính mình từ Server Component (fetch('/api/products')) — thêm một lượt HTTP vô ích; gọi thẳng hàm truy cập dữ liệu.

Waterfall và cách loại bỏ

// ❌ Tuần tự: 300ms + 400ms + 200ms = 900ms
const user = await getUser(id);
const orders = await getOrders(id);
const recs = await getRecommendations(id);

// ✅ Song song: max(300, 400, 200) = 400ms
const [user, orders, recs] = await Promise.all([getUser(id), getOrders(id), getRecommendations(id)]);

Tuần tự chỉ khi thật sự phụ thuộc (cần user.teamId mới lấy được team). Waterfall còn ẩn trong cây component: page await xong mới render con, con lại await. Cách xử lý: bắt đầu fetch sớm ở cha (không await), truyền Promise xuống, hoặc tách các phần độc lập vào các <Suspense> riêng để chúng chạy song song.

// Mẫu preload: bắt đầu tải trước khi cần
export const preloadOrders = (id: string) => { void getOrders(id); };   // getOrders được bọc cache()

Dùng chung dữ liệu trong một request: cache()

Layout, page và generateMetadata cùng cần getUser(). Không cần truyền props hay context — gọi ở cả ba nơi, nhưng bọc hàm bằng cache() của React để chỉ chạy một lần mỗi request.

// lib/data.ts
import 'server-only';
import { cache } from 'react';

export const getCurrentUser = cache(async () => {
  const session = await verifySession();
  return db.query.users.findFirst({ where: eq(users.id, session.userId) });
});

fetch với cùng URL và options trong một lần render cũng được tự dedupe (request memoization). Đây là bộ nhớ trong một request, khác với cache dữ liệu lâu dài ở Module 6.

Streaming với loading.tsx và Suspense

// app/dashboard/page.tsx
import { Suspense } from 'react';

export default function Dashboard() {
  return (
    <>
      <h1>Tổng quan</h1>                                   {/* gửi ngay */}
      <Suspense fallback={<CardsSkeleton />}><RevenueCards /></Suspense>   {/* 300ms */}
      <Suspense fallback={<ChartSkeleton />}><SalesChart /></Suspense>     {/* 1.2s */}
      <Suspense fallback={<TableSkeleton />}><LatestOrders /></Suspense>   {/* 2s */}
    </>
  );
}

async function LatestOrders() {
  const orders = await getLatestOrders();   // mỗi component tự fetch, chạy song song
  return <OrdersTable orders={orders} />;
}

Server gửi HTML khung + skeleton ngay, rồi stream từng phần khi xong (cùng một response HTTP). Người dùng thấy nội dung sau vài chục ms thay vì chờ 2 giây. loading.tsx là cách viết tắt: bọc cả page trong một Suspense.

  • Đặt boundary theo ý nghĩa với người dùng: phần nào nên hiện cùng nhau thì chung boundary.
  • Skeleton đúng kích thước để không gây CLS.
  • Status code và header đã gửi khi bắt đầu stream — notFound()/redirect() gọi sau đó vẫn chạy được (Next.js chèn meta/script), nhưng status HTTP có thể đã là 200. Kiểm tra tồn tại trước khi stream nếu cần 404 chuẩn cho SEO.

Truyền Promise xuống Client Component

// Server
export default function Page() {
  const reviewsPromise = getReviews('p1');       // không await
  return (
    <Suspense fallback={<p>Đang tải đánh giá…</p>}>
      <Reviews reviewsPromise={reviewsPromise} />
    </Suspense>
  );
}

// Client
'use client';
import { use } from 'react';
export function Reviews({ reviewsPromise }: { reviewsPromise: Promise<Review[]> }) {
  const reviews = use(reviewsPromise);           // stream dữ liệu xuống, component vẫn tương tác được
  const [sort, setSort] = useState<'new' | 'top'>('new');
  // ...
}

Dữ liệu chỉ cần ở client (infinite scroll, polling, cập nhật realtime) thì vẫn dùng TanStack Query/SWR ở Client Component — có thể nạp dữ liệu ban đầu từ server qua initialData hoặc prefetch + HydrationBoundary.

🚩 Sai lầm hay gặp

  • Ba await nối tiếp nhau cho dữ liệu độc lập.
  • Gọi fetch('/api/...') của chính app từ Server Component.
  • Một loading.tsx duy nhất ở root cho mọi trang.

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

Dashboard stream từng phần

Dashboard 4 khối với API giả lập độ trễ 200ms-3s. Phiên bản 1: await tuần tự trong page (đo TTFB). Phiên bản 2: Promise.all. Phiên bản 3: Suspense từng khối. Ghi lại thời gian thấy nội dung đầu tiên cho mỗi phiên bản. Dùng cache() để layout và page cùng lấy user mà chỉ query một lần (log để chứng minh).

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

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

  • Tôi nhận ra waterfall trong code và trong cây component
  • Tôi dùng cache() để dùng chung dữ liệu trong một request
  • Tôi đặt được Suspense boundary theo trải nghiệm người dùng
  • Tôi truyền được Promise xuống Client Component