Реализация React Server Components для веб-приложения

Реализация React Server Components для веб-приложения

React Server Components (RSC) — это не SSR в привычном смысле. Это принципиально новая модель компонентов: серверные компоненты выполняются только на сервере, никогда не гидратируются на клиенте, не добавляют ни байта в JS-бандл. Они могут обращаться к базе данных напрямую, читать файловую систему, использовать серверные секреты — всё это без API-слоя.

RSC меняет не фреймворк — RSC меняет то, как вы думаете о компонентах.

Server Components vs Client Components

// СЕРВЕРНЫЙ компонент (по умолчанию в App Router)
// Этот код НИКОГДА не попадает в браузер

import { db } from '@/lib/db'; // Прямой импорт Prisma/Drizzle — нормально
import { unstable_cache } from 'next/cache';

const getProducts = unstable_cache(
  async (categoryId: string) => {
    return db.product.findMany({
      where: { categoryId, published: true },
      include: { images: { take: 1 }, _count: { select: { reviews: true } } },
      orderBy: { createdAt: 'desc' },
    });
  },
  ['products'],
  { revalidate: 300, tags: ['products'] }
);

export async function ProductList({ categoryId }: { categoryId: string }) {
  const products = await getProducts(categoryId);

  return (
    <ul>
      {products.map(product => (
        <li key={product.id}>
          {/* ProductCard — тоже серверный компонент */}
          <ProductCard product={product} />
          {/* AddToCartButton — клиентский компонент */}
          <AddToCartButton productId={product.id} />
        </li>
      ))}
    </ul>
  );
}

// КЛИЕНТСКИЙ компонент — 'use client' обязателен
'use client';

import { useState, useTransition } from 'react';
import { addToCart } from '@/actions/cart'; // Server Action

export function AddToCartButton({ productId }: { productId: string }) {
  const [isPending, startTransition] = useTransition();

  return (
    <button
      onClick={() => startTransition(() => addToCart(productId))}
      disabled={isPending}
    >
      {isPending ? 'Добавляем...' : 'В корзину'}
    </button>
  );
}

Что могут и чего не могут Server Components

Server Components МОГУТ:

• async/await на верхнем уровне компонента
• Прямые запросы к БД без API
• Читать переменные окружения (включая секреты)
• Импортировать server-only библиотеки
• Рендерить другие серверные и клиентские компоненты

Server Components НЕ МОГУТ:

• Использовать useState, useEffect, useContext
• Обрабатывать браузерные события (onClick, onChange)
• Использовать браузерные API (localStorage, window)
• Принимать функции как пропсы (не сериализуется)

Server Actions — мутации без API

// app/actions/products.ts
'use server';

import { revalidateTag } from 'next/cache';
import { redirect } from 'next/navigation';
import { db } from '@/lib/db';
import { auth } from '@/lib/auth';
import { z } from 'zod';

const UpdateProductSchema = z.object({
  name: z.string().min(1).max(255),
  price: z.number().positive(),
  description: z.string().optional(),
});

export async function updateProduct(
  productId: string,
  prevState: ActionState,
  formData: FormData
): Promise<ActionState> {
  const session = await auth();
  if (!session?.user) return { error: 'Unauthorized' };

  const parsed = UpdateProductSchema.safeParse({
    name: formData.get('name'),
    price: Number(formData.get('price')),
    description: formData.get('description'),
  });

  if (!parsed.success) {
    return { error: parsed.error.flatten().fieldErrors };
  }

  await db.product.update({
    where: { id: productId },
    data: parsed.data,
  });

  revalidateTag('products');
  redirect(`/products/${productId}`);
}

// Использование в форме через useActionState
'use client';
import { useActionState } from 'react';
import { updateProduct } from '@/actions/products';

export function EditProductForm({ product }: { product: Product }) {
  const [state, action, isPending] = useActionState(
    updateProduct.bind(null, product.id),
    null
  );

  return (
    <form action={action}>
      <input name="name" defaultValue={product.name} required />
      {state?.error?.name && <p>{state.error.name[0]}</p>}

      <input name="price" type="number" defaultValue={product.price} />

      <button type="submit" disabled={isPending}>
        {isPending ? 'Сохранение...' : 'Сохранить'}
      </button>
    </form>
  );
}

Оптимизация: context и провайдеры

Распространённая ошибка — оборачивать всё приложение в Client Component с провайдером:

// Плохо: весь layout становится клиентским
'use client';
export function Layout({ children }) {
  return <ThemeProvider><AuthProvider>{children}</AuthProvider></ThemeProvider>;
}

// Хорошо: провайдеры изолированы, children — серверные
// providers.tsx
'use client';
export function Providers({ children }: { children: React.ReactNode }) {
  return <ThemeProvider><QueryProvider>{children}</QueryProvider></ThemeProvider>;
}

// layout.tsx — серверный
import { Providers } from './providers';
export default async function RootLayout({ children }) {
  const session = await auth(); // Серверный запрос в layout
  return (
    <html>
      <body>
        <Providers session={session}>{children}</Providers>
      </body>
    </html>
  );
}

Паттерн: передача серверных данных через props

// Серверный компонент передаёт данные клиентскому
export default async function ProductPage({ params }: Props) {
  const product = await getProduct(params.id);
  const recommendations = await getRecommendations(product.categoryId);

  return (
    <div>
      {/* Серверные компоненты рендерят статичный контент */}
      <ProductDetails product={product} />
      <ProductImages images={product.images} />

      {/* Клиентский получает только нужные данные — не весь product */}
      <ProductCarousel
        items={recommendations.map(r => ({ id: r.id, name: r.name, image: r.images[0]?.url }))}
      />
    </div>
  );
}

Размер бандла до и после RSC

Типичный результат миграции продуктовых страниц на RSC:

Серверные компоненты не добавляют JS — они добавляют только HTML в поток ответа.

Сроки реализации

• Неделя 1–2: аудит существующих компонентов, разметка server/client границ, перенос data-fetching из API routes в серверные компоненты
• Неделя 3: Server Actions для форм и мутаций, замена REST-вызовов на прямые DB-запросы
• Неделя 4: оптимизация провайдеров (вынос на клиент без загрязнения layout), кэширование через unstable_cache
• Неделя 5: измерение JS bundle до/после, тесты (jest-environment для RSC), документация границ
• Неделя 6: деплой, мониторинг серверного рендера, обучение команды