Fehler 413 beim Hochladen: Upload-Grenzen sauber einstellen
Kurz gesagt: Wenn Kunden beim Hochladen von Fotos, Plänen oder Unterlagen eine leere Seite, eine Meldung „413“ oder gar nichts sehen, ist die Datei meist größer als eine der Grenzen auf Ihrem Server. Solche Grenzen gibt es oft mehrfach: im Webserver, in der Programmiersprache und manchmal zusätzlich beim Hoster oder im CDN. nginx lässt laut Dokumentation standardmäßig nur 1 MB pro Anfrage zu, PHP standardmäßig 2 MB pro Datei. Stimmen Sie alle Grenzen aufeinander ab, prüfen Sie die Dateigröße schon im Browser und zeigen Sie eine verständliche Meldung, statt Kunden mit einem Fehlercode allein zu lassen.
Woran Sie das Problem erkennen
Upload-Grenzen fallen meist erst auf, wenn ein Kunde etwas Größeres schicken will als beim Testen:
- Das Formular lädt lange und zeigt dann eine leere oder kryptische Fehlerseite.
- Im Browser erscheint „413 Request Entity Too Large“ oder „413 Content Too Large“.
- Das Formular wird scheinbar abgeschickt, aber die Datei fehlt, und manchmal fehlen auch alle anderen Eingaben.
- Kleine Fotos funktionieren, Handyfotos in voller Auflösung oder mehrseitige Scans nicht.
Gerade bei Handwerksbetrieben, Planungsbüros und Werkstätten, die Fotos von Schäden oder Plänen anfordern, ist das ärgerlich. Der Kunde gibt nach dem zweiten Versuch auf und ruft an, oder er meldet sich gar nicht mehr.
Was der Status 413 bedeutet
Laut MDN heißt der Status heute „413 Content Too Large“, früher „Payload Too Large“. Er besagt, dass die Anfrage größer ist als die Grenzen, die der Server festgelegt hat. Der Server darf dabei die Verbindung schließen. Die nginx-Dokumentation weist außerdem darauf hin, dass Browser diesen Fehler nicht korrekt darstellen können. Das erklärt, warum Kunden oft nur eine leere Seite oder eine abgebrochene Verbindung sehen.
Die Grenzen, die zusammenspielen
Eine Datei muss auf ihrem Weg mehrere Stationen passieren. Jede kann sie aufhalten.
Webserver nginx: Die Einstellung client_max_body_size begrenzt die Größe des gesamten Anfragekörpers. Der Standardwert ist laut Dokumentation 1m, also 1 MB. Wird der Wert überschritten, antwortet nginx mit 413. Der Wert 0 schaltet die Prüfung ab, was Sie aber nicht tun sollten.
PHP: Hier gibt es laut PHP-Handbuch mehrere Werte. upload_max_filesize begrenzt die einzelne Datei, standardmäßig 2M. post_max_size begrenzt die gesamten Formulardaten, standardmäßig 8M, und muss größer sein als upload_max_filesize. max_file_uploads legt fest, wie viele Dateien pro Anfrage erlaubt sind, standardmäßig 20. Das Handbuch empfiehlt außerdem, memory_limit größer als post_max_size zu wählen.
Andere Laufzeitumgebungen: Auch Frameworks in Node.js, Python oder anderen Sprachen haben eigene Grenzen für Anfragekörper. Diese stehen in der Dokumentation der verwendeten Bibliothek für Formulare oder Uploads.
Hoster, Load Balancer und CDN: Vor Ihrem Server kann eine weitere Grenze liegen. Die kennen Sie oft erst, wenn Sie in die Unterlagen Ihres Anbieters schauen.
Besonders tückisch ist PHP: Überschreitet die Anfrage post_max_size, sind die Formulardaten auf dem Server leer. Die Anwendung meldet dann womöglich „Bitte Pflichtfelder ausfüllen“, obwohl der Kunde alles ausgefüllt hat.
Die passende Größe festlegen
Überlegen Sie, was Kunden realistisch schicken: Ein Handyfoto hat je nach Gerät einige Megabyte, ein mehrseitiger Scan als PDF kann deutlich größer sein. Legen Sie eine Grenze pro Datei und eine für das gesamte Formular fest und stimmen Sie die Werte von außen nach innen ab:
- Grenze im CDN oder Load Balancer: am größten oder gleich groß.
- Grenze im Webserver: etwas größer als die Summe aller erlaubten Dateien plus Formularfelder.
- Grenze in der Anwendung: genau die Werte, die Sie Kunden kommunizieren.
So greift im Normalfall die Anwendung zuerst, und die kann eine verständliche Meldung zeigen. Die äußeren Grenzen dienen nur als Schutz gegen übergroße Anfragen.
Setzen Sie die Grenzen nicht beliebig hoch. Große Uploads belasten Speicher und Bandbreite, und ein offenes Formular ohne Grenze lädt zum Missbrauch ein.
Im Browser vorab prüfen
Viel freundlicher als jede Fehlerseite ist eine Prüfung vor dem Absenden. Mit wenigen Zeilen JavaScript lässt sich die Größe einer ausgewählten Datei auslesen und mit Ihrer Grenze vergleichen. Ist sie zu groß, zeigt das Formular direkt neben dem Feld einen Hinweis wie „Die Datei ist 14 MB groß. Erlaubt sind 10 MB. Bitte verkleinern Sie das Foto oder schicken Sie es in zwei Teilen.“
Nennen Sie die erlaubte Größe außerdem schon in der Feldbeschreibung. Bei Fotos hilft es, sie vor dem Upload im Browser zu verkleinern. Diese Prüfung ersetzt die Grenzen am Server aber nicht, denn wer will, kann sie umgehen.
Eine eigene Fehlerseite für 413
Falls doch eine äußere Grenze greift, sollte der Kunde nicht vor einer leeren Seite stehen. In nginx lässt sich für den Status 413 eine eigene Fehlerseite hinterlegen. Sie erklärt kurz, dass die Datei zu groß war, nennt die erlaubte Größe und bietet eine Alternative an, etwa eine E-Mail-Adresse oder einen Link zum erneuten Versuch.
Testen, bevor Kunden es tun
Ein strukturierter Test dauert eine Viertelstunde:
- Laden Sie eine Datei knapp unter der Grenze hoch: Sie muss ankommen.
- Laden Sie eine Datei knapp darüber hoch: Es muss die freundliche Meldung erscheinen, nicht ein Fehlercode.
- Laden Sie die maximale Anzahl Dateien auf einmal hoch.
- Prüfen Sie nach einem Fehlversuch, ob die übrigen Formulareingaben erhalten bleiben.
- Wiederholen Sie den Test mit dem Handy über mobile Daten.
Wiederholen Sie diesen Test nach jedem Hosterwechsel und jedem größeren Update, denn dabei werden Einstellungen gern auf Standardwerte zurückgesetzt.
Beispiel aus der Praxis
Ein Dachdeckerbetrieb in Salzburg bittet Kunden im Anfrageformular um Fotos vom Dach. Viele Anfragen kamen ohne Fotos an, manche ganz ohne Text. Der Server ließ nur kleine Anfragen zu, und bei zu großen Handyfotos waren in der Anwendung alle Felder leer. Nach dem Abstimmen der Grenzen, einer Prüfung im Browser und einer verständlichen Meldung kommen Fotos und Beschreibung wieder zusammen an. Das Beispiel ist illustrativ.
Häufige Fragen
Warum kommen nach einem großen Upload auch die anderen Felder leer an?
Bei PHP ist dann meist post_max_size überschritten. In diesem Fall verwirft PHP die gesamten Formulardaten, nicht nur die Datei.
Reicht es, die Grenze in PHP zu erhöhen?
Nein. Auch der Webserver und gegebenenfalls Hoster oder CDN haben Grenzen. Alle müssen zusammenpassen.
Welche Größe ist für Fotos sinnvoll?
Das hängt von Ihren Anforderungen ab. Wenn Sie Fotos nur zur Einschätzung brauchen, verkleinern Sie diese im Browser und halten die Grenze moderat.
Wie zeige ich die Meldung, wenn der Server die Anfrage abbricht?
Hinterlegen Sie im Webserver eine eigene Fehlerseite für 413 und prüfen Sie die Größe zusätzlich vorab im Browser.
Wenn Uploads in Ihrem Formular verloren gehen, stimmen wir die Grenzen gerne gemeinsam mit Ihnen ab: Upload-Formular prüfen lassen.