Как исправить 404 на Vercel
Ошибка 404 после deploy — одна из самых частых проблем на Vercel и Next.js-проектах. В этом гайде разберём, почему страницы перестают открываться после публикации, как проверить routes, dynamic pages, redirects, sitemap и production deployment, а также как безопасно вернуть сайт в рабочее состояние.
Что означает ошибка 404
Ошибка 404 означает, что сервер не может найти нужную страницу или route.
На production проблема может проявляться иначе, чем локально: главная работает, а внутренние страницы отдают 404.
В Next.js и Vercel ошибки 404 часто связаны с routes, slug, generateStaticParams или неправильной структурой страниц.
- Страница отсутствует.
- Route настроен неправильно.
- Dynamic page не попала в build.
- Redirect указывает на несуществующий URL.
- Sitemap содержит битые страницы.
- Production deployment использует старую структуру.
Почему 404 появляется после deploy
Локально проект может работать нормально, но production использует другую сборку, environment и routing.
Часто проблема появляется после нового deploy, изменения slug, удаления файла или изменения структуры routes.
- Изменился slug страницы.
- Страница удалена из build.
- Dynamic params не генерируются.
- Redirect настроен неправильно.
- Production использует старый deployment.
- Sitemap ссылается на несуществующий URL.
- Route работает локально, но не работает после build.
Проверьте routes и структуру страниц
Первое, что нужно проверить — действительно ли нужная страница существует в проекте.
В Next.js route напрямую зависит от структуры папок и файлов.
- Проверьте наличие файла страницы.
- Проверьте app router или pages router.
- Проверьте slug.
- Проверьте регистр букв в пути.
- Проверьте nested routes.
- Проверьте route groups, если используются.
- Убедитесь, что route существует после build.
Dynamic pages и generateStaticParams
В Next.js dynamic routes требуют отдельной генерации страниц. Если generateStaticParams работает неправильно, production может не получить нужные URL.
Частая ошибка: локально route открывается, а production build не знает о нужном slug.
- Проверьте generateStaticParams.
- Проверьте список slug.
- Убедитесь, что данные доступны во время build.
- Проверьте fallback behavior.
- Проверьте fetch данных для dynamic pages.
- Проверьте, что slug не undefined.
- Убедитесь, что route попадает в production build.
Redirects и rewrite ошибки
Redirect может случайно отправлять пользователя на несуществующий URL.
Rewrite и redirect особенно опасны при SEO-миграциях или изменении структуры сайта.
- Проверьте redirects.
- Проверьте rewrite rules.
- Проверьте trailing slash.
- Проверьте старые URL.
- Проверьте canonical после redirect.
- Проверьте sitemap после изменения routes.
- Не оставляйте redirect loops.
Sitemap и SEO-проблемы после 404
Если sitemap содержит битые URL, Google продолжит пытаться индексировать несуществующие страницы.
После изменения структуры сайта sitemap нужно обновлять.
- Проверьте sitemap.xml.
- Удалите несуществующие URL.
- Проверьте canonical.
- Проверьте robots.txt.
- Проверьте Search Console coverage.
- Убедитесь, что важные страницы индексируемы.
- Не отправляйте 404 страницы в sitemap.
Как проверить production deployment
Иногда проблема не в route, а в том, что production deployment использует старую версию проекта.
После изменений важно проверить, какой deployment сейчас активен.
- Откройте Vercel Deployments.
- Проверьте последний production deploy.
- Убедитесь, что deploy успешен.
- Проверьте build logs.
- Проверьте branch production.
- Проверьте, что commit действительно задеплоен.
- Откройте production URL в инкогнито.
Частые причины 404 на Vercel
Большинство ошибок 404 можно найти через системную проверку routes, deployment и SEO-настроек.
Не стоит менять всё сразу — лучше проверять слой за слоем.
- Route отсутствует в проекте.
- Ошибка slug.
- generateStaticParams возвращает неправильные данные.
- Страница не попала в build.
- Redirect указывает на битый URL.
- Sitemap содержит удалённые страницы.
- Домен подключён не к тому проекту.
- Deploy использует старую branch.
- Ошибка case-sensitive путей.
- Production deployment сломан.
Как безопасно исправлять 404
Ошибки 404 лучше исправлять аккуратно, особенно если URL уже попал в Google.
Резкое удаление страниц может повредить SEO и внутренней перелинковке.
- Не меняйте slug без необходимости.
- Используйте redirect для старых URL.
- Проверяйте sitemap после изменений.
- Проверяйте internal links.
- Проверяйте Search Console coverage.
- Делайте deploy только после build.
- Проверяйте production перед отправкой в индекс.
Production checklist для 404 ошибок
Этот checklist помогает быстро проверить основные причины production 404 после deploy.
Его стоит проходить после крупных SEO-изменений, редизайна или migration routes.
- Route существует.
- slug корректный.
- generateStaticParams работает.
- Build проходит.
- Deploy успешен.
- Production URL открывается.
- Redirects работают.
- Sitemap обновлён.
- Canonical корректный.
- Internal links не ведут на 404.
- Search Console не показывает массовые ошибки.
Связанные гайды AIWEBNET
404 часто связан с routes, slug, sitemap и production deployment. После исправления проверьте 500 ошибки и домен.
Что делать дальше
После исправления 404 важно проверить Search Console, обновить sitemap и убедиться, что Google видит актуальную структуру сайта.
Для AIWEBNET особенно важно поддерживать стабильную перелинковку между guides, blog, tools и cluster pages.
- Обновите sitemap.
- Проверьте Search Console.
- Исправьте internal links.
- Проверьте canonical.
- Проверьте redirects.
- Следите за coverage errors.
- Проверяйте production после каждого deploy.