SSR и маршрутизация SPA
На этой странице
SSR отвечает за первоначальный документ, а клиентский роутер может обслуживать последующие переходы без полной перезагрузки страницы.
Вопрос
Как совмещаются серверный первый рендер и клиентская навигация?
Основная идея
При прямом открытии /books/42 сервер должен распознать маршрут, загрузить книгу и вернуть подходящий HTML. Если он отдаёт только пустую оболочку и ждёт клиентский код, это уже другой сценарий первоначального рендера. Неизвестный маршрут должен получить корректный статус и страницу ошибки.
После гидрации клиентский роутер перехватывает внутренние переходы, обновляет URL и подгружает данные или код следующего маршрута. При этом полный HTML-документ не обязательно запрашивается заново. Фреймворк может использовать отдельный протокол данных и серверного дерева.
Сервер и клиент должны одинаково понимать маршруты и исходные данные. Иначе прямое открытие, обновление страницы и внутренний переход будут вести себя по-разному. Ссылки с настоящим href сохраняют базовую семантику браузера; специализированный Link добавляет клиентскую навигацию и может поддерживать предзагрузку.
Последовательность
1. Прямое открытие /books/42 (или F5)
браузер ──GET /books/42──▶ сервер: маршрут → данные → HTML (+статус 200/404)
браузер ◀── HTML + JS ──── показывает контент сразу
JS загрузился → гидратация → клиентский роутер «берёт управление»
2. Клик по <Link href="/books/43">
роутер перехватывает клик, history.pushState('/books/43')
──запрос данных/кода маршрута──▶ сервер (JSON, RSC-пейлоад или loader)
◀── только данные ── React обновляет изменившуюся часть, layout остаётся
3. «Назад»
popstate → роутер показывает /books/42 (часто из клиентского кэша)| Первый запрос | Клиентский переход | |
|---|---|---|
| Что приходит | Полный HTML-документ | Данные (JSON / RSC) и код маршрута |
| Кто выбирает маршрут | Сервер | Клиентский роутер |
| Статус-коды | Реальные HTTP (404, 301) | Роутер показывает свою страницу ошибки |
| Состояние на странице | Создаётся заново | Общие layout и их state сохраняются |
Главное требование: одна и та же таблица маршрутов на сервере и клиенте (во фреймворках — автоматически, по файлам или конфигу), иначе F5 и клик по ссылке покажут разное.
Пример
Пример для Next.js App Router; каждый блок кода сохраните в файл, указанный над ним.
app/page.jsx
import Link from 'next/link';
export default function Home() {
return <main>
<h1>Библиотека</h1>
<Link href="/books">Открыть каталог</Link>
</main>;
}app/books/page.jsx
export default function BooksPage() {
return <main><h1>Каталог книг</h1><p>React без паники</p></main>;
}Прямое открытие /books обслуживает серверная инфраструктура Next.js. Переход по Link внутри уже загруженного приложения использует клиентскую навигацию. Стратегия подготовки конкретного маршрута может быть статической или динамической.
Что важно помнить
- Пример требует Next.js App Router и двух файлов в показанных каталогах.
- Наличие Link не означает, что приватные данные можно загружать без серверной авторизации.
- Предзагрузка полезна, но её поведение зависит от фреймворка и типа маршрута.
- SSR не требует полной перезагрузки на каждый переход.
Мини-шпаргалка
Первый URL → серверный маршрут. Hydration → клиентский роутер. Link → переход. Reload → снова сервер.