Новая запись в базе не обязана создавать новый файл в уже выпущенном статическом каталоге. Сравните момент появления товара со сборкой и выясните, как система обслуживает путь, которого в сборке не было. Первый шаг — найти один тестовый slug в источнике, результате генерации параметров и опубликованном артефакте.
Проверяйте на тестовом каталоге и сохраняйте прежний артефакт. Не удаляйте рабочий релиз ради повторной сборки. Запишите установленную версию Next.js, App Router и режим размещения: статический экспорт файлов и работающий сервер имеют разные возможности. Дальше важна именно эта развилка, а не общая команда «очистить кэш».
Товар до сборки и товар после неё
| Случай | Что проверяем | Вывод |
|---|---|---|
| Запись была до build | Попала ли она в выборку параметров | Ошибка отбора или формирования slug |
| Запись появилась после build | Есть ли обслуживание нового пути | Нужен предусмотренный механизм появления страницы |
| Путь создан, на сайте 404 | Тот ли артефакт опубликован | Проверка развёртывания |
| Путь открывается, список его не видит | Свежесть списка и ссылок | Отдельная проблема навигации |
Условный пример: генератор выбирает только первую страницу ответа каталога. Тестовый товар существует, но находится дальше и никогда не входит в параметры. Сравните полноту разрешённой выборки, фильтр опубликованности и нормализацию slug. Не создавайте путь для закрытого или чернового товара только ради устранения 404.
generateStaticParams имеет свой момент выполнения
В документации Next.js указано: при next build generateStaticParams выполняется до генерации соответствующих страниц; при ISR-revalidation функция заново не вызывается. Источник проверен 12 октября 2026 года. Повторное обновление содержимого существующего пути поэтому нельзя считать доказательством повторного перечисления всего каталога.
Условный контрольный опыт:
A: опубликован до сборки
build: зафиксированный момент и ревизия
B: опубликован после сборки
check: прямые URL A и B
deployment_mode: static export / работающий сервер
expected_new_path_policy: <согласованное поведение>Для экспорта статических файлов новый путь должен попасть в новый подходящий артефакт и быть развёрнут. Для работающего сервера исследуйте его настроенную политику неизвестных параметров и поддерживаемую генерацию по запросу. Возможности зависят от конфигурации версии; не предлагайте один флаг как универсальный ответ обоим режимам.
Отдельно выясните, откуда сборка читает данные. Администратор мог добавить товар в рабочую базу, а build использует согласованный снимок или другой источник. Не печатайте строки подключения в отчёт. Достаточно безопасного обозначения окружения, времени выборки и числа полученных параметров, сопоставленных с ожидаемым каталогом.
Публикация страницы заканчивается проверкой ссылок
- Подтвердить допустимость тестовых товаров A и B к публикации.
- Проверить их пути по принятой политике.
- Открыть каждый прямой URL после развёртывания.
- Проверить ссылки каталога и включение нужных URL в sitemap.
- Испытать отсутствие и снятие товара по правилам продукта.
Наличие ссылки в sitemap не создаёт страницу. Сначала подтвердите ответ URL и корректное содержимое, затем список адресов. Если сборка не удалась, старый работоспособный артефакт должен оставаться доступным в рамках процедуры развёртывания. Нельзя объявлять новый товар опубликованным только по успешной записи в административной форме.
Для разбора сохраните время создания товара, результат выборки параметров, режим размещения и ревизию опубликованной сборки. Эти четыре наблюдения отделяют пропущенный параметр от отсутствия механизма новых путей и позволяют исправить нужный этап без разрушения существующего каталога.