re:re:actable
Урок 103 минуты чтения

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 → снова сервер.

Документация

Next.js: Linking and Navigating.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам