RSC и Server Actions на практике: куда ставить "use client"
О React Server Components написано много, но большинство статей пытается их объяснить. Я же хочу написать о другом: о том, какие правила оказались полезны на практике после года работы с ними.
Самый краткий вывод такой: вся сложность RSC сводится к одному решению — куда вы поставите `"use client"`.
Граница заразна сверху вниз
Первое и самое дорогое знание: "use client" помечает не один файл, а всю ветку.
Если вы пометили компонент клиентским, всё, что он импортирует, тоже уедет на клиент. И их импорты тоже. Цепочка уходит вниз без ограничений.
Практическое следствие такое. Допустим, в самом верху страницы есть один маленький интерактивный элемент — например, переключатель темы. Если поставить "use client" на уровне layout, на клиент переедет вся страница.
Правильное решение — опускать границу как можно ниже:
// app/[lang]/blog/page.tsx — серверный компонент
import { LikeButton } from './like-button'
export default async function BlogPage() {
const posts = await getPosts() // на сервере
return (
<main>
{posts.map((p) => (
<article key={p.slug}>
<h2>{p.title}</h2>
<LikeButton slug={p.slug} /> {/* только это на клиенте */}
</article>
))}
</main>
)
}// like-button.tsx
'use client'
export function LikeButton({ slug }: { slug: string }) {
const [count, setCount] = useState(0)
return <button onClick={() => setCount((c) => c + 1)}>{count}</button>
}Здесь на клиент уходит только кнопка. Текст статьи, заголовки, получение данных — всё остаётся на сервере.
Когда "use client" действительно нужен
Список короткий, его легко запомнить. Клиентский компонент нужен, если есть:
useState,useReducer,useEffectи другие хуки- Обработчики событий:
onClick,onChange,onSubmit - Браузерные API:
window,localStorage,IntersectionObserver - Библиотеки, работающие только на клиенте
Всё остальное может и должно быть серверным компонентом.
Полезен и обратный вопрос: а этот компонент вообще не интерактивен? Если нет, ему на клиенте делать нечего.
Откуда брать данные
Самая большая практическая польза RSC в том, что для получения данных не нужно писать API-эндпоинт.
Раньше поток был такой: компонент делает fetch в useEffect, тот идёт в /api/posts, а он общается с базой. Три слоя.
Теперь серверный компонент спрашивает напрямую:
export default async function Page() {
const posts = await db.select().from(postsTable)
return <PostList posts={posts} />
}Промежуточного слоя нет. Это уменьшает объём кода и убирает один источник ошибок — рассинхрон типов между API и компонентом.
Важная деталь: этот код выполняется только на сервере, поэтому обращаться к базе напрямую безопасно. Но именно поэтому нужно быть осторожным: любые данные, переданные из серверного компонента в клиентский, видны пользователю. Не передавайте объект пользователя целиком, выбирайте нужные поля.
Server Actions: когда они уместны
Server Actions — способ обработать отправку формы без написания API.
async function addComment(formData: FormData) {
'use server'
const text = formData.get('text') as string
await db.insert(comments).values({ text })
revalidatePath('/blog')
}
export function CommentForm() {
return (
<form action={addComment}>
<textarea name="text" />
<button type="submit">Отправить</button>
</form>
)
}Это красиво, и для простых форм я этим пользуюсь.
Но в двух случаях я всё же пишу обычный route handler.
Первый — когда нужен ответ. Server Action может возвращать результат, но если поток усложняется (ошибки валидации, частичный успех, прогресс), обычный эндпоинт понятнее.
Второй — когда есть внешний потребитель. Если к вашему API обращается мобильное приложение или другой сервис, Server Action им бесполезен. Он существует только для вашей страницы.
Важное напоминание: Server Action — это открытый HTTP-эндпоинт, просто спрятанный. В нём обязательно должны быть аутентификация и валидация. Предположение «это вызывается только из моей формы» неверно.
Ловушка, делающая страницу динамической
Теперь о самом дорогом уроке.
Статьи в моём блоге должны были работать через ISR: страница генерируется заранее и обновляется раз в пять минут. В коде это настроено.
Потом я измерил и выяснил, что ни одна страница не генерируется заранее. Все собираются на каждый запрос.
Причина оказалась в неожиданном месте: в самом верхнем layout был вызов headers(). Он использовался для чтения языковой настройки.
Правило такое: если headers(), cookies() или searchParams вызываются где угодно в дереве, вся ветка становится динамической. Статическая генерация становится невозможной, потому что ответ нельзя собрать, не видя запроса.
Хуже всего, что это происходит молча. Ни ошибки, ни предупреждения. Ваша настройка ISR остаётся на месте, просто никогда не работает.
Отсюда практический совет: каждый раз читайте вывод bun run build. Он перечисляет, какие маршруты статические, а какие динамические. Если список отличается от ожидаемого — сразу ищите причину.
В моём случае решением было убрать headers() из layout. Я этого не сделал, и причина простая: страницы блога и так быстрые, а динамичность мне не вредит. Но важно другое — я об этом знаю. Неопределённости нет.
Практические рекомендации
Короткий список, оставшийся после года работы:
- Состояние по умолчанию — серверный компонент.
"use client"ставится только при явной причине. - Опускайте границу как можно ниже. Клиентским компонентом должна быть кнопка, а не страница.
- Передавайте в клиентский компонент только нужные поля, а не объект целиком.
- Server Action — для простых форм. Для сложного потока или внешнего потребителя пишите route handler.
- В каждом Server Action должны быть аутентификация и валидация.
- Читайте список статических и динамических маршрутов в выводе сборки. Неожиданный динамический маршрут — сигнал к проверке.
Последний пункт экономит больше всего времени, потому что большинство ошибок в RSC не выдают ошибку — они просто молча отключают ожидаемую оптимизацию.