Stránka pod jazykovým segmentem věří parametru – 500 místo 404
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Roboti zkoušející adresy typu /__ENV.js dostávali od webu chybu 500 a v logu serveru přibývaly chyby validace databázového dotazu („neplatná hodnota výčtu jazyka“). Běžná neexistující adresa (/xyz) vracela správně 404. Ve vývojovém režimu vracela 404 i problémová adresa, takže lokální testy nic neukázaly – 500 se objevilo jen v produkčním buildu.
Root cause
Sekce “Root cause”Matcher middleware vynechává cesty končící příponou statického souboru:
export const config = { matcher: ["/((?!_next/static|_next/image|.*\\.(?:ico|png|js|css|txt|xml)$).*)"] };Jazykové směrování proto /foo.js nepřepíše na /<výchozí-jazyk>/foo.js. Neexistuje-li takový statický soubor, směrovač cestu přiřadí dynamickému segmentu [locale] s hodnotou foo.js – a jednosegmentová cesta odpovídá úvodní stránce [locale]/page.
Layout hodnotu ověřil a zavolal notFound(), stránka ale ne:
if (!hasLocale(routing.locales, locale)) notFound();
// [locale]/page.tsx – vykresluje se souběžně s layoutemconst data = await loadHomeData(locale as Locale); // dotaz s neplatnou hodnotou výčtu → výjimkaLayout a stránka se vykreslují paralelně. notFound() v layoutu běh stránky nezruší; její výjimka z databázové vrstvy v produkčním buildu vyhraje a odpověď je 500. Vývojový server tutéž situaci vyhodnotí jako 404 (chybu jen zaloguje), takže rozdíl dev × produkce chybu skrýval.
Fix
Sekce “Fix”Stejná kontrola na začátku stránky, před jakýmkoli čtením dat:
const { locale } = await params;if (!hasLocale(routing.locales, locale)) notFound();Regresní testy: jednotkový test volá komponentu stránky s neplatným jazykem a čeká chybu „nenalezeno“ bez jediného dotazu do databáze (selže i ve vývojovém prostředí); HTTP test proti produkčnímu buildu čeká 404 pro /foo.js, /__ENV.js, /favicon.png a 200 pro skutečné statické soubory.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
curl -o /dev/null -w '%{http_code}' https://<web>/foo.jsproti produkčnímu buildu; v logu hledat chyby validace s hodnotou jazyka, která vypadá jako název souboru. - Anti-pattern:
params.locale as Localebez ověření; spoléhání na to, že „middleware tam nic jiného nepustí“ – matcher s výjimkami podle přípon nebo prefixů znamená, že část požadavků middleware nevidí. - Lepší přístup: ověření parametru ve stránce (nebo ve sdíleném pomocníku volaném každou stránkou); chování 404/500 testovat proti produkčnímu buildu, ne jen proti vývojovému serveru.
Sister bugs / související
Sekce “Sister bugs / související”- Chování podle editovatelného slugu tiše zmizí – další důvěra v hodnotu z adresy.