Индексация React, Next.js и Vite SPA: SSR, пререндеринг и паритет HTML
Почему клиентские SPA-приложения плохо ранжируются без серверного HTML и как статический пререндеринг решает проблему без тяжёлого бэкенда.
Дмитрий К., Technical SEO Lead · SEO Space
Ориентиры корректной индексации
- Исходный HTML
- 100% H1, текста и ссылок
- LCP (мобильный)
- <= 1.8 с
- INP (отклик)
- <= 150 мс
- Сдвиг макета CLS
- < 0.05
Первая волна обхода против отложенной очереди рендеринга JS
Даже если Googlebot умеет выполнять JavaScript через Web Rendering Service, обработка JS ставится во вторую очередь с ограниченными ресурсами. Яндекс и ИИ-краулеры тем более часто ограничиваются первичным парсингом HTML или не ждут долгих клиентских запросов к API.
Базовый стандарт для любого коммерческого сайта на React, Next.js или Vue — 100% паритет исходного HTML: при запросе через curl страница должна сразу отдавать нужный <title>, canonical, hreflang, H1, текст, ссылки и JSON-LD.
Опасно полагаться на тезис «Google уже научился исполнять JS». В конкурентных коммерческих нишах вторая очередь рендеринга задерживает обновление цен и новых посадочных на дни, а Яндекс и парсеры нейропоиска (Yandex Neuro, Perplexity, ChatGPT Search) в большинстве случаев опираются именно на первичный сырой HTML.
Критичная ошибка с useEffect
Никогда не формируйте <link rel="canonical">, мета-тег robots и ключевой JSON-LD только внутри клиентского useEffect(). Краулер считывает эти директивы из первичного ответа сервера до выполнения клиентских хуков.
Статический пререндеринг для сайтов без тяжёлого сервера
Если маркетинговые и контентные страницы не зависят от авторизации конкретного пользователя, вам не нужен дорогой Node-кластер в продакшене. Скрипт пререндеринга на этапе npm run build прогоняет React renderToString по всем маршрутам (главная, локали, раздел блога и статьи) и сохраняет готовые HTML-файлы в dist/.
// Схема статического пререндеринга (SSG)
1. vite build -> клиентский бандл с hydrateRoot
2. vite build --ssr -> серверная точка входа
3. node scripts/prerender.mjs -> генерация dist/**/index.html + JSON-LD
4. CDN отдаёт готовый HTML за < 50 мс Ошибки гидратации и скрытый контент во вкладках
Исключайте зависимость первичного рендера от объекта window. Ключевые блоки, справочники и ссылки на смежные страницы должны присутствовать в DOM-дереве сразу, а не подгружаться только по клику пользователя.
Потоковый SSR (Streaming) и порядок отдачи метаданных
При использовании React Server Components и Suspense в Next.js медленные внешние запросы могут отодвинуть критичный коммерческий контент за пределы короткого окна ожидания краулера. Главный заголовок H1, таблицы тарифов, карточки характеристик и блоки FAQ должны отдаваться синхронно в первом потоке HTML.
Контроль гидратации и стабильность мобильного макета
Ошибки расхождения серверного и клиентского рендеринга (Hydration Mismatch) заставляют React полностью перерисовывать DOM на клиенте, резко ухудшая INP и вызывая сдвиги экрана.
- Изолируйте браузер-зависимые компоненты (время, размеры экрана, пользовательские виджеты) в клиентские островки без ломки базового HTML.
- Проверяйте каждый релиз командой `curl -sL URL` в CI: в ответе обязаны присутствовать title, H1, текст и JSON-LD.
- Для маркетинговых и контентных разделов рассмотрите переход на статический Astro SSG с минимальным весом JS.
Нужно проверить индексацию вашего проекта?
Пришлите домен: вручную проверим исходный HTML, логи обхода, дубли фильтров, canonical и карту сайта в течение 24 часов.