astro ssg routing bug

баг с роутингом в astro в режиме ssg

когда
30 мая 2026 г.
метки
astro · routing · ssg · bug
время чтения
1 мин чтения

момент который заставил погуглить повайбкодить

исторически nginx и другие классические веб-серверы обрабатывают директории и файлы по разному

при запросе на /about:

1. /about/index.html — если сервер не находит файл, но находит директорию с тем же именем, он делает редирект на /about/, где уже ищет index.html
2. about.html — отдаётся напрямую

в astro я подключил клиентский роутинг, а само приложение работало как SSG — нужно было на первый запрос отдавать готовую страницу, а последующие переходы обрабатывать на клиенте

так вот редиректы вызывали релоад и ломали клиентскую навигацию из-за дефолтного формата билда astro (см. скрин 1)

фиксанул с помощью format: file изменив формат билда (см. скрин 2)

p.s. удивительно что vercel для каждого фреймворка научились резолвить пути, там все работало из коробки

p.p.s. интересная статья, не совсем мой случай, но близко https://aaronjbecker.com/posts/astro-nginx-url-trailing-slashes/

скрин 1
скрин 1