Přeskočit na obsah

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’;

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.

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:

  1. uloží jen prvních 10 MB,
  2. vypíše do logu serveru varování,
  3. 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.

Zvednout limit proxy na hodnotu, která pokrývá největší přijímaný soubor a není nižší než limit reverzní proxy:

next.config.ts
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í”
Přidal aiarchitekt.cz · 16. 11. 2026 1:00
Provozuje aiarchitekt.cz