Если метатеги не обновляются при серверном рендеринге, сравните два конкретных маршрута и полный ответ каждого. Зафиксируйте ожидаемые title и description, параметры страницы и источник этих значений. Не ограничивайтесь первым фрагментом ответа или заголовком вкладки после клиентского перехода.
Начните с публичных тестовых страниц, у которых явно разные названия. Не используйте личные сведения в metadata и диагностическом HTML. Запишите установленную версию Next.js, App Router или Pages Router и режим развёртывания. Далее рассматривается App Router; переносить его API в другой механизм без проверки нельзя.
Откуда пришло старое название
| Наблюдение | Возможная причина | Следующая проверка |
|---|---|---|
| Оба маршрута имеют общий title | Общая metadata без нужного уточнения | Маршрутный источник и параметры |
| Тело новое, description старая | Два разных источника данных | Версии чтения для тела и metadata |
| Прямая загрузка верна, переход нет | Различие путей навигации | Результат после перехода и полного открытия |
| Первый фрагмент без metadata | Потоковое формирование | Полный ответ и профиль получателя |
Проверьте, какой компонент маршрута формирует данные и какое значение у него при этой ссылке. Условный пример: тело читает товар по slug, а description приходит из общего шаблона. Это не обязательно ошибка кэша. Запишите происхождение каждого поля, прежде чем очищать все слои хранения или менять режим рендеринга.
Потоковый ответ нельзя оценить по первому куску
В текущей документации Next.js generateMetadata может завершаться после отправки начального интерфейса; при streaming metadata теги добавляются в body. Для HTML-limited bots используется блокирующее формирование с metadata в head. Эти условия проверены 12 октября 2026 года. Сравнивайте законченный ответ и реальный профиль получателя, не обещая одинакового первого фрагмента всем клиентам.
Условная таблица наблюдений:
route: /catalog/demo-a
expected_title: Демонстрационный товар A
response_profile: браузер / согласованный бот
complete_response_title: <значение>
complete_response_description: <значение>
body_record_id: <обезличенный ID>Смена User-Agent в диагностике должна быть осознанной и только для разрешённого чтения собственных страниц. Успех для одного профиля не доказывает поведение остальных. Не отключайте streaming глобально первым действием: сначала подтвердите, что причина связана с ним, и оцените влияние изменения на время ответа. Для старой версии найдите её соответствующий контракт.
Если metadata и основной текст требуют одной записи, согласуйте идентичность и актуальность чтения. Нельзя исправить расхождение только красивым названием вкладки, оставив неправильный серверный ответ. Для отсутствующей записи и ошибки внешнего источника заранее определите безопасные значения или отказ; описание другого товара не должно служить случайным fallback.
Проверка после изменения — две ссылки и два пути
- Прямо открыть тестовые страницы A и B.
- Сравнить полные title и description с ожидаемыми.
- Перейти A → B штатной навигацией и проверить итог.
- Повторить разрешённое чтение для нужного профиля робота.
- Проверить отсутствие дублей и личных данных в metadata.
Метаданные и содержимое должны рассказывать об одном объекте. Если есть canonical и Open Graph, сопоставьте их с тем же маршрутом; не добавляйте неподтверждённые URL ради заполнения полей. Проверка ограничивается теми получателями и режимами, которые реально испытаны. Кэш превью внешнего сервиса — отдельная задача после подтверждения правильного ответа сайта.
Для передачи проблемы сохраните версию фреймворка, два адреса, происхождение значений и полный обезличенный ответ. Такой набор отделяет ошибку генерации metadata от неверного способа её наблюдения и помогает выбрать точечное изменение с возвратом.