Статический пререндеринг 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 часов.