Что делает сервер до отправки HTML
На этой странице
Сервер сопоставляет запрос с маршрутом, проверяет доступ, загружает нужные данные и рендерит ответ с правильными статусом и заголовками.
Вопрос
Какие этапы проходит SSR-запрос до отправки страницы браузеру?
Основная идея
SSR начинается не с вызова React. Сначала HTTP-сервер или фреймворк разбирает адрес, cookies и заголовки, выбирает маршрут и определяет контекст пользователя. Приватные данные разрешено загружать только после проверки доступа. Затем получают данные страницы и решают, какой статус нужен: успех, редирект или отсутствие ресурса.
Дальше React создаёт HTML. Для гидрации браузеру понадобится тот же исходный снимок данных и клиентский bundle. Сериализация этого снимка должна быть безопасной: обычный JSON нельзя без подготовки вставлять в script-тег. Фреймворки обычно скрывают большую часть инфраструктурной работы.
При streaming сервер может отправить оболочку раньше, чем завершены все блоки. Поэтому статус, cookies и критичные заголовки нужно определить до начала потока: после отправки заголовков изменить HTTP-код уже нельзя. Параллельная загрузка независимых данных уменьшает серверный водопад.
Конвейер SSR-запроса
GET /orders/42 (cookies, Accept-Language, User-Agent)
│
▼ 1. Маршрутизация /orders/:id → OrderPage, id = "42"
▼ 2. Сессия и доступ cookie → user; нет → 302 /login; чужой заказ → 403
▼ 3. Данные (параллельно) Promise.all([getOrder(42), getUser(), getRecommendations()])
▼ 4. Статус и заголовки нет заказа → 404; Cache-Control: private; Set-Cookie
▼ 5. Рендер React renderToPipeableStream(<App data={...} />)
▼ 6. Сериализация данных безопасный JSON для гидрации (экранирование <)
▼ 7. Ответ HTML + <script src="client.js"> → браузер → гидратация| Шаг | Если пропустить или сделать позже |
|---|---|
| Проверка доступа до загрузки данных | Утечка приватных данных |
| Статус до начала стриминга | 404 отдастся как 200 (soft 404) |
| Параллельная загрузка | Последовательные await — медленный TTFB |
| Безопасная сериализация | XSS через </script> в данных |
Cache-Control: private для личных страниц | CDN закэширует чужие данные |
Пример
Серверный JSX-модуль Node.js; экспортируемый handleProfile передают в HTTP-сервер после настройки преобразования JSX.
import { renderToString } from 'react-dom/server';
function Profile({ name }) {
return <main><h1>Профиль: {name}</h1></main>;
}
export async function handleProfile(request, response) {
// Учебные данные. В реальном маршруте здесь проверка сессии и запрос к БД.
const url = new URL(request.url, 'http://localhost');
if (url.pathname !== '/profile') {
response.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' });
response.end('<h1>Страница не найдена</h1>');
return;
}
const html = renderToString(<Profile name="Анна" />);
response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
response.end('<!doctype html>' + html);
}Функция предназначена для подключения к Node HTTP-серверу. Она выбирает маршрут и статус до отправки тела. Для упрощения страница статическая и не подключает гидрацию.
Что важно помнить
- Не загружайте приватные данные до авторизации и не храните их в общем глобальном объекте.
- API-ошибки обрабатывайте до начала ответа либо предусмотрите поведение незавершённого потока.
- React экранирует текстовые JSX-значения, но ручные HTML-вставки требуют отдельного анализа.
Мини-шпаргалка
Request → маршрут/доступ → данные → статус/headers → render → безопасный ответ.