Ilya Dyomin
Ilya Dyomin

Dyomin Ilya

Software Developer from Kazakhstan

alkhipce@mail.ru

astro ssg routing bug

published on 29.05.2026

astroroutingssgbug

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

photo_2025-07-12_03-11-30.jpg
photo_2025-07-12_03-11-31.jpg

исторически 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/