Next proxy mlčky ořízne tělo požadavku nad 10 MB – nahrání většího souboru selže obecnou chybou
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Aplikace deklaruje limit nahrávání 15 MB pro obrázky a 25 MB pro dokumenty a reverzní proxy pouští 30 MB. Přesto nahrání platného obrázku o velikosti 12 MB skončí:
400 {"error":"Očekáván multipart/form-data."}Soubory do ~10 MB projdou. Všechny dosavadní zkoušky (automatické i ruční) používaly soubory do několika MB, takže chyba nebyla vidět.
Root cause
Sekce “Root cause”V aplikaci je proxy.ts (dříve middleware.ts), jehož matcher zahrnuje i /api/*. Aby tělo požadavku mohla číst proxy i navazující handler, Next ho klonuje a ukládá do paměti. Velikost tohoto bufferu omezuje volba experimental.proxyClientMaxBodySize (dříve middlewareClientMaxBodySize), výchozí hodnota je 10 MB.
Při překročení Next:
- uloží jen prvních 10 MB,
- vypíše do logu serveru varování,
- požadavek nechá pokračovat – klient žádnou chybu nedostane.
Request body exceeded 10MB for /api/<cesta-nahrávání>. Only the first 10MB will be available unless configured.Handler pak zavolá req.formData() nad neúplným tělem (chybí konec multipart obálky), parsování selže a kód to přeloží jako „požadavek není multipart“. Limit aplikace (15/25 MB) se nikdy neuplatní, protože se k němu žádný soubor nad 10 MB nedostane.
Fix
Sekce “Fix”Zvednout limit proxy na hodnotu, která pokrývá největší přijímaný soubor a není nižší než limit reverzní proxy:
const nextConfig: NextConfig = { experimental: { proxyClientMaxBodySize: "30mb", },};A přidat testy, které shodu vrstev hlídají:
- test jednotek: limit proxy ≥ největší limit souboru v aplikaci + rezerva na obálku formuláře, a zároveň ≥ každý limit v konfiguraci reverzní proxy;
- E2E: poslat soubor nad limitem aplikace (např. 16 MB při limitu 15 MB) a čekat její vlastní hlášku „Soubor je příliš velký“. Takový test dokazuje, že tělo dorazilo celé, a přitom na serveru nic neuloží, takže může běžet i proti živému webu.
Alternativa: vyjmout cesty nahrávání z matcheru proxy – tělo se pak neukládá vůbec, ale tyto cesty přijdou o kontroly, které proxy dělá.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -i "Request body exceeded" <log aplikace>; ručně nahrát soubor těsně pod nejvyšším deklarovaným limitem. Podezřelé je každé „neplatný formát požadavku“ u velkého souboru. - Anti-pattern: ověřovat nahrávání jen malým souborem; ladit limit jen v reverzní proxy a v handleru a zapomenout na vrstvu mezi nimi; překládat každou chybu parsování těla jako „špatný formát“ bez ohledu na velikost.
- Lepší přístup: mít jeden přehled limitů těla napříč vrstvami a test, který selže, když vnitřní vrstva pouští méně než vnější. Pozor na paměť: vyšší limit proxy znamená větší buffer na každý požadavek – vnější vrstva by proto měla velké tělo pouštět jen na cesty nahrávání.
Sister bugs / související
Sekce “Sister bugs / související”- Stránka pod jazykovým segmentem věří parametru – 500 místo 404 – další chování vrstvy proxy/middleware, které běžné testy neodhalí.
- Validace těla před autorizací a pole bez limitu – vyčerpání paměti – limity velikosti těla jako ochrana paměti.