JS и SSR Обновлено 2026-11-16 3 мин Vite · React · Googlebot

Статический пререндеринг Vite SPA: маршруты, Head-инъекция и гидратация

Переход от голого клиентского index.html к пререндерингу маршрутов при сборке даёт TTFB до 35 мс и 100% видимость для любых ботов.

Дмитрий К., Technical SEO Lead · SEO Space

Ориентиры корректной индексации

Покрытие URL
100% маршрутов
TTFB с CDN
< 35 мс по миру
Ошибки гидратации
0 предупреждений

Устранение пустого div#root в Vite-приложениях

Обычная сборка Vite отдаёт один пустой файл `dist/index.html`, заставляя поисковых и ИИ-ботов запускать JS ради чтения заголовков и ссылок.

Запуск скрипта пререндеринга после `vite build` прогоняет каждый маршрут через `renderToString` и сохраняет готовый `/route/index.html` с локализованным `<head>`.

for (const route of allRoutes) {
  const { html, headTags } = await renderRoute(route);
  const doc = template.replace('<!--head-->', headTags).replace('<!--app-->', html);
  writeHtmlFile(route, doc);
}

Защита от ложных Soft 404 на статическом хостинге

Не отдавайте `200 /index.html` на неизвестные адреса — настройте CDN или Node-сервер на возврат честного кода 404 со страницей `404.html`.

  • Формируйте реестр пререндеринга и `sitemap.xml` из единого массива маршрутов.
  • Синхронизируйте начальное состояние `hydrateRoot()`, избегая расхождений и скачков CLS.
  • Вшивайте локализованные `canonical` и `hreflang` статически на этапе сборки.

Пререндеринг сборки против динамического SSR

Используйте статический пререндеринг для сайтов до 15–20 тысяч страниц, переходя на гибридный SSR/ISR при секундном изменении остатков.

Режим доставки Масштаб каталога Стоимость хостинга
Vite Build Pre-Render 100 – 15 000 страниц Минимальная (CDN статика)
Гибридный Edge SSR / ISR 15 000+ живых SKU Воркер + сброс кэша по вебхуку
Чистый клиентский SPA Только закрытые ЛК Провал на не-JS и ИИ-краулерах

Нужно проверить индексацию вашего проекта?

Пришлите домен: вручную проверим исходный HTML, логи обхода, дубли фильтров, canonical и карту сайта в течение 24 часов.