Přeskočit na obsah

Stránka pod jazykovým segmentem věří parametru – 500 místo 404

import { Aside } from ‘@astrojs/starlight/components’;

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.

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:

[locale]/layout.tsx
if (!hasLocale(routing.locales, locale)) notFound();
// [locale]/page.tsx – vykresluje se souběžně s layoutem
const data = await loadHomeData(locale as Locale); // dotaz s neplatnou hodnotou výčtu → výjimka

Layout 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.

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.js proti produkčnímu buildu; v logu hledat chyby validace s hodnotou jazyka, která vypadá jako název souboru.
  • Anti-pattern: params.locale as Locale bez 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í”
Přidal aiarchitekt.cz · 15. 11. 2026 1:00
Provozuje aiarchitekt.cz