AI-читабельность — это способность важной информации на веб-странице корректно, актуально и в машинно-понятном виде считываться агентами искусственного интеллекта. Например, если в HTML, который формирует сервер, цена товара указана как 1.299 TL, а после выполнения JavaScript в браузере отображается 1.249 TL, значит формируются два разных слоя контента. Короткий ответ: Hydration mismatch сам по себе не обязательно отправляет старые данные AI-боту; однако если актуальная информация загружается только на стороне клиента или SSR-вывод остается в кэше, некоторые агенты могут прочитать устаревшие или неполные данные из первого HTML.
Поэтому цель — не просто создать страницу, которая выглядит правильно в браузере, а измерить разницу между сырым HTTP-ответом, видом без JavaScript и DOM после выполнения JavaScript. Не все AI-системы используют один и тот же способ сканирования: одни обрабатывают только HTTP-ответ, другие могут использовать браузер с выполнением JavaScript. Вместо того чтобы предполагать, какой слой читается, примените 6 проверок к одному и тому же URL.
Как hydration mismatch приводит к тому, что AI-бот видит старые данные?
Hydration mismatch возникает, когда HTML с сервера и первый результат рендера React на клиенте отличаются. Риск устаревших данных чаще всего появляется из-за stale SSR-кэша, загрузки данных на стороне клиента или сочетания значений, меняющихся со временем. Поэтому mismatch — это симптом, а несогласованность в потоке данных — главная область проверки.
SSR — это первый HTML, который сервер отправляет в браузер. Этот HTML можно увидеть даже до запуска JavaScript. Во время hydration React привязывает обработчики событий к этой разметке и сопоставляет ее со своим виртуальным деревом. Если первый рендер на клиенте отличается от текста, атрибутов или структуры узлов на сервере, в консоли может появиться ошибка или предупреждение. Хотя React может исправлять некоторые текстовые расхождения, это не означает, что контент останется актуальным для всех ботов.
По каким 6 проверкам можно найти разницу между SSR и HTML клиента?
1. Есть ли актуальные данные в первом HTTP-ответе?
Сначала зафиксируйте, что именно отправляет сервер, не выполняя JavaScript. Если в теле ответа нет заголовка, цены, остатка, даты или структурированных данных, контент нельзя прочитать без JS. Если ответ уже устарел, проблема находится до hydration — в источнике данных или на уровне кэша.
В командной строке запросите один и тот же URL с разными значениями User-Agent. Один лишь User-Agent не имитирует реального AI-сканера, но он может показать, не отвечает ли CDN или сервер по-разному в зависимости от правил.
curl -sSL -D headers.txt -A 'Mozilla/5.0' 'https://ornekalanadi.com/urun/abc' -o ssr-browser.html
curl -sSL -D ai-headers.txt -A 'GPTBot' 'https://ornekalanadi.com/urun/abc' -o ssr-ai.html
grep -in '1.249|stokta|Product' ssr-browser.html
2. Что меняется между View Source и живым DOM?
View Source в браузере в основном показывает исходный HTML, пришедший с сервера; панель Elements — живой DOM после JavaScript. Сохраните оба вывода отдельно и сравните важные узлы контента. Если значения цены, описания, даты и данные внутри JSON-LD не совпадают, это укажет на источник расхождения.
Наличие различий не всегда означает SEO-ошибку. Например, привязка обработчиков событий в React не меняет видимый текст. С другой стороны, удаление текста о наличии товара на клиенте или его добавление только на клиенте может напрямую повлиять на AI-читабельность.
3. В каком компоненте возникает ошибка hydration в React?
Сохраните предупреждение о hydration и информацию о component stack из консоли браузера. В React 18 и более новых версиях можно отслеживать события в production с помощью onRecoverableError для hydrateRoot. Если вы только отключили логирование ошибки, это не значит, что проблема решена.
hydrateRoot(root, <App initialData={initialData} />, {
onRecoverableError(error, info) {
console.warn('Hydration farkı', error.message, info.componentStack);
}
});
Логируйте сообщение об ошибке вместе с URL, компонентом и версией данных; не отправляйте персональные данные. Если одно и то же предупреждение на странице появляется в 3 разных компонентах, ищите общий формат даты, locale или генератор начальных данных.
4. Меняют ли дату, время, locale или случайные значения первый рендер?
Date.now(), Math.random(), часовой пояс браузера, формат валюты и источники вроде window могут давать разные результаты на сервере и на клиенте. На сервере формируйте фиксированную ISO-даты или заранее отформатированную метку; изменяемое значение на клиенте обновляйте уже после hydration внутри useEffect.
Например, если сервер работает в UTC, а браузер — в часовом поясе Europe/Istanbul, один и тот же временной штамп может преобразоваться в другую дату. Если в первом HTML вам нужно показать точную дату, передавайте и текст, и версию данных с сервера на клиент в одном и том же payload.
5. Актуальные данные приходят только через fetch на стороне клиента?
Если контент загружается внутри useEffect, он может быть невидим для клиента с отключенным JavaScript и для агента, который читает только HTTP-ответ. Для критической информации поместите начальные данные в первый SSR-ответ. Клиентский fetch может получать последнее обновление, но первый рендер должен начинаться с того же стартового значения.
Если цена товара, которую SSR сгенерировал в 10:00, и цена, которую клиент получил через API в 10:01, отличаются, это может быть ожидаемым обновлением. Но если AI-агент обрабатывает только первый HTML, он никогда не увидит вторую цену. Зафиксируйте это различие вместе с источником контента, временем генерации и временем ответа API.
6. Хранят ли CDN, ISR или кэш приложения старый SSR-вывод?
Проверьте заголовки ответа: Age, ETag, Last-Modified, Cache-Control и статус кэша, специфичный для CDN. Даже если сервер получил актуальную цену из базы данных, CDN может вернуть HTML, которому уже 300 секунд. В момент изменения контента используйте purge, короткую revalidation или подходящую политику no-store.
Тест с рандомным параметром запроса, который отключает кэш, не всегда отражает реальный путь посетителя. Поэтому сравнивайте обычный URL с 2 или 3 разных сетей, с одинаковыми заголовками и с фиксацией временной метки. Если тело ответа 200 отличается, проверьте также правило вариаций.
Технический чек-лист
- Сохраните сырой HTML страницы с помощью
curl; отметьте важный текст, canonical и поля JSON-LD. - Сравните вывод View Source с DOM из Elements после JavaScript; отделяйте не только класс или обработчик событий, но и различия в видимом контенте.
- Отключите JavaScript и проверьте, читаются ли необходимые данные для товара, статьи или услуги.
- Отслеживайте предупреждения React в консоли вместе с URL, компонентом и версией данных; не используйте
suppressHydrationWarningкак замену исправлению. - Исключите дату, время, locale и случайные значения из первого рендера или передавайте одинаковое значение с сервера на клиент.
- Проверьте TTL, ETag, revalidation и purge в CDN и кэше приложения в момент обновления контента.
Пример сценария: цена товара в SSR устарела, а в DOM уже обновлена
На странице интернет-магазина ERP обновляет товар до 1.249 TL. Но из-за TTL CDN в 300 секунд сервер продолжает отдавать HTML с ценой 1.299 TL. После hydration React-компонент делает запрос к API, и в браузере показывается 1.249 TL. Пользователь видит правильную цену в панели Elements, а AI-читатель без выполнения JS может найти в сыром HTML 1.299 TL.
Правильное исправление — не просто отключить предупреждение hydration. Нужно обеспечить, чтобы SSR брал данные из актуального источника, CDN очищался после обновления ERP, а клиент использовал то же начальное значение. Следующий шаблон сохраняет серверную метку в первом рендере на клиенте и позволяет ей измениться контролируемо после получения ответа API:
function Price({ initialLabel, initialValue }) {
const [price, setPrice] = useState({
label: initialLabel,
value: initialValue
});
useEffect(() => {
fetch('/api/price/abc', { cache: 'no-store' })
.then(response => response.json())
.then(nextPrice => setPrice(nextPrice));
}, []);
return <p data-price={price.value}>{price.label}</p>;
}
Здесь initialLabel и initialValue должны передаваться в SSR и клиент одинаково. Ответ API может, например, возвращать { label: '1.249 TL', value: 1249 }. Во время теста сначала сохраните файл ssr.html, затем DOM в браузере с включенным JavaScript; после этого с помощью diff -u проверьте не только узел цены, но и JSON-LD, а также текст доступности.
Если страница действительно обновляет переменные данные на клиенте, измерьте, когда именно происходит это обновление. Например, fetch, завершающийся за 180 миллисекунд, может быть виден пользователю в браузере; но агент, который вообще не рендерит серверный ответ, этого времени не переживает. С точки зрения AI-читабельности критическая информация должна быть в первом HTML и соответствовать вашей политике актуальности данных.
Частые ошибки
- Считать, что подавление предупреждения hydration исправляет старый или неполный контент.
- Проверять только скриншот и вообще не изучать сырой HTTP-ответ.
- Оставлять цену, остаток или тело статьи только на API-вызов внутри
useEffect. - Использовать разные locale, часовой пояс или формат валюты на сервере и на клиенте.
- Предполагать, что обновление контента мгновенно опубликовано, не проверив очистку CDN-кэша.
- Обобщать поведение одного браузерного бота на всех AI-агентов.
В итоге hydration mismatch — это сигнал, что сначала нужно сравнить SSR-вывод с первым рендером клиента. Чтобы понять, действительно ли старые данные уходят AI-боту, анализируйте сырой ответ, вид без JavaScript, живой DOM, логи React и заголовки кэша на одном и том же URL.