next start -H 127.0.0.1 zacyklí úvodní stránku výchozího jazyka
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Při přezkoušení kandidáta na nasazení vracel lokální produkční server na českém úvodu / odpověď 307 s Location: / – nekonečnou smyčku. /en a /de vracely 200 a živý web se stejným kódem vracel na / také 200. Vypadalo to jako regrese v kandidátovi.
Root cause
Sekce “Root cause”Web má výchozí jazyk bez prefixu (localePrefix: "as-needed"): middleware požadavek na / vnitřně přepisuje na /<výchozí-jazyk> a požadavek na /<výchozí-jazyk> naopak přesměrovává na /.
Server byl spuštěn s volbou hostitele:
next start -p <port> -H 127.0.0.1Odpověď pak nesla:
HTTP/1.1 307 Temporary Redirectx-middleware-rewrite: http://localhost:<port>/<výchozí-jazyk>location: /Cíl přepisu má hostitele localhost, server je ale svázán s 127.0.0.1. Přepis se proto nepovažuje za vnitřní, ale za přepis na jiný původ: framework pošle nový HTTP požadavek na /<výchozí-jazyk>, ten projde middleware podruhé a ta ho přesměruje na /. Klient dostane 307 na adresu, ze které přišel. Jazyky s prefixem přepis nepotřebují, proto fungují.
| Spuštění | / |
|---|---|
bez -H | 200 |
-H localhost | 200 |
-H 0.0.0.0 | 200 |
-H 127.0.0.1 | 307 → / |
Stejně se choval i starší, už nasazený build – s testovanou změnou smyčka nesouvisela.
Fix
Sekce “Fix”Změna kódu nebyla potřeba: produkce server spouští bez -H (naslouchá na všech rozhraních za reverzní proxy) a smyčka se tam nevyskytuje. Opraven byl postup zkoušky – lokální produkční build se spouští stejným příkazem jako na serveru a nasazovací skript po restartu kontroluje, že úvody všech jazyků vracejí 200.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
curl -sI http://127.0.0.1:<port>/a porovnat hostitele vx-middleware-rewrites adresou, na které server naslouchá; smyčku odhalícurl -L --max-redirs 5. - Anti-pattern: zkoušet kandidáta v jiné konfiguraci spuštění než produkce a nález přičíst diffu; neověřit tentýž scénář na předchozím buildu.
- Lepší přístup: u podezřelé regrese vždy spustit stejnou sondu i proti nasazené verzi ve stejném prostředí – rozdíl mezi verzemi, ne mezi prostředími, je to, co se hledá.
Sister bugs / související
Sekce “Sister bugs / související”- Stránka pod jazykovým segmentem věří parametru – 500 místo 404 – další chování, které se liší podle způsobu spuštění (dev × produkční build).