Сначала установите, что развёрнуто: статический экспорт Next.js или приложение с серверным runtime. У статического сайта новый slug не появляется только потому, что запись добавили в CMS. Сравните один URL, существовавший во время сборки, с одним новым и сохраните результат прямого открытия обоих адресов.
Не включайте общее перенаправление всех 404 на главную ради проверки. Оно маскирует отсутствующие страницы и не создаёт их содержимое. Воспроизведите production build из того же commit с теми же безопасными настройками источника данных и выясните, попал ли нужный путь в результат.
Список параметров — часть статического выпуска
В App Router generateStaticParams задаёт параметры для генерации динамических маршрутов. Руководство Next.js, проверенное 3 ноября 2026 года, также описывает dynamicParams: при запрете неопределённых параметров не включённый путь может отвечать 404. Сверяйте поведение с установленной версией Next.js и её конфигурацией кеширования.
| Результат | Следующий участок |
|---|---|
| Нет в build | Выборка и параметры |
| Есть в build, нет на хостинге | Доставка артефакта |
| Переход работает, прямой URL нет | Обработка URL хостингом |
| Runtime возвращает 404 | Параметры и логика notFound |
Отдельно проверьте output: 'export'. Документация Static Exports описывает выпуск готового статического сайта и ограничения динамических маршрутов. Наличие сервера nginx перед файлами не превращает экспорт в работающий Next.js runtime. Генерация новых страниц во время запроса требует поддерживаемой архитектуры развёртывания.
Условный пример: generateStaticParams прочитал только первую страницу API CMS. Старые товары попали в export, остальные отсутствуют. Исправляйте полноту выборки и её пагинацию, затем пересобирайте сайт. Разрешение proxy на больший тайм-аут не добавит пропущенные slug в готовый артефакт.
Есть ли страница до загрузки на хостинг?
Условная матрица:
старый slug: build / direct HTTP / переход
новый slug: build / direct HTTP / переход
несуществующий slug: ожидаемый 404
режим: export или server runtimeСопоставьте проблемный slug с выводом генерации и структурой результата экспорта. Учитывайте вложенные сегменты и настройки окончания URL. Не выводите закрытые данные CMS в build log: достаточно счётчика путей, безопасного тестового slug и причины его исключения.
Если маршрут отсутствует уже в локальном production-артефакте, исследуйте источник данных, фильтр публикации и параметры. Если присутствует локально, но отсутствует после доставки, сравните состав и идентификатор выпуска. Папка на сервере может содержать смесь прежних и новых файлов после неполного копирования.
Проверьте пару условий: прямой запрос в новой вкладке и переход по ссылке внутри приложения. Их различие часто указывает на разницу между обработкой URL хостингом и клиентским переходом. Успешная навигация в уже открытой вкладке не заменяет приёмку публичного URL прямым HTTP-запросом.
Серверный режим проверяется своим способом
Если используется Next.js runtime, сравните запуск production-сборки с опубликованным окружением. Сохраните статус ответа и журнал обработки маршрута. Причина 404 может находиться в прикладном notFound(), недоступной записи или запрете неизвестных параметров, а не в отсутствии файла экспорта.
Не переносите пример настройки dynamicParams из другой версии и режима вслепую. Современная документация отдельно описывает Cache Components; набор поддерживаемых сочетаний зависит от проекта. Выберите нужную модель по установленной версии и подтвердите её минимальным маршрутом на стенде.
Для статического выпуска решите, когда новая запись становится публичной: через пересборку и атомарную замену артефакта либо через другую поддерживаемую модель. Добавление записи в CMS и доставка сайта — два события. Интерфейс публикации должен отражать это различие, чтобы редактор не получал обещание уже работающего URL раньше времени.
- Определить режим развёртывания и версию.
- Сравнить известный и новый slug в production build.
- Проверить доставленный артефакт и прямой URL.
- Сохранить настоящий 404 для отсутствующего объекта.
После исправления проверьте старый slug, новый опубликованный slug и заведомо отсутствующий. Последний должен сохранять корректный ответ об отсутствии. Для расследования подготовьте версию Next.js, режим сборки, commit, список безопасных контрольных URL и результаты до и после доставки. Тогда исправление проверяет маршрут, а не просто меняет внешний вид страницы ошибки.