TYPO3 Glossar

502 Schlechtes Gateway

502 Schlechtes Gateway in TYPO3

502 Bad Gateway zeigt an, dass der Server keine gültige Antwort von einem Upstream-Server erhalten hat. In TYPO3 kann dies auftreten, wenn ein Proxy-Server ausfällt oder die TYPO3-Instanz nicht gut mit externen Ressourcen kommuniziert. Eine Fehlersuche in der Serverkonfiguration oder eine Kontaktaufnahme mit Ihrem Host kann das Problem beheben.

Wichtige Tipps für 502 Bad Gateway in TYPO3:

  • Überprüfen Sie die Serverkonfigurationen für Upstream-Verbindungen.
  • Wenden Sie sich an Ihren Hosting-Provider, um Unterstützung zu erhalten, falls das Problem weiterhin besteht.

Ein 502-Fehler tritt auf, wenn ein Server als Vermittler eine ungültige Antwort von einem nachgelagerten Server erhält. In typischen TYPO3-Umgebungen sitzt ein Reverse-Proxy oder Webserver wie Nginx vor PHP-FPM; antwortet PHP nicht oder bricht die Verbindung ab, erscheint die Meldung „Bad Gateway“.

Häufige Auslöser sind überlastete oder abgestürzte PHP-Prozesse, zu knappe Timeouts bei langen Anfragen, fehlerhafte Konfigurationen nach einem Update oder Probleme bei Caching-Schichten und Load Balancern. Ein Blick in die Fehlerprotokolle von Webserver und PHP zeigt meist, an welcher Stelle die Kette reißt.

Zur Vorbeugung helfen ausreichend dimensionierte Server, ein sinnvolles Caching und Monitoring, das Ausfälle meldet, bevor Besucher sie bemerken. Planen Sie zudem eine verständliche Fehlerseite und Wartungsfenster für größere Änderungen, damit Besucher wissen, wann sie es erneut versuchen sollten.

Wenn der Fehler nur sporadisch auftritt, lohnt sich ein Lasttest: Er zeigt, ab wie vielen gleichzeitigen Zugriffen die Antwortzeiten kippen, und liefert Hinweise, ob mehr Ressourcen oder eine optimierte Konfiguration nötig sind.

Bei Hosting-Anbietern lohnt sich außerdem die Nachfrage, ob Limits für gleichzeitige Prozesse oder Speicher erreicht wurden. Oft lässt sich das Problem mit angepassten PHP-FPM-Einstellungen beheben, ohne dass sofort ein größerer Server nötig ist.

Dokumentieren Sie Vorfälle mit Zeitpunkt, Ursache und Lösung. Dieses kleine Protokoll hilft Ihrem Team, wiederkehrende Muster zu erkennen und beim nächsten Mal schneller zu reagieren.

Kurz gesagt: 502 Fehler in TYPO3: Gateway Problem beheben leicht.