Ein Absturz, der zu keinem Besucher passt
Freitag, 13. November 2026, kurz nach halb fünf am Nachmittag. Im Fehlerprotokoll der internationalen Weinplattform VINUM, die wir technisch betreuen, stehen zwei PHP-Abstürze, vier Sekunden auseinander. Der erste lautet:
PHP Fatal error: Maximum execution time of 240 seconds exceeded
Ein PHP-Prozess hat also vier Minuten lang gerechnet und wurde dann abgebrochen. Das allein ist schon ungewöhnlich – normale Seitenaufrufe sind bei VINUM in deutlich unter einer Sekunde fertig. Das eigentliche Rätsel begann aber erst beim Blick in das Zugriffsprotokoll des Webservers: Kein einziger Aufruf an diesem Tag hatte länger als 61 Sekunden gedauert. Kein Fehlercode, kein Abbruch, nichts, was zu einem vierminütigen Absturz passte.
Ein Fehler ohne Spur. Solche „Geisterfehler“ sind unangenehm, weil man sie leicht als Einzelfall abhakt – bis sie wiederkommen und dann einen Server lahmlegen. Dieser Beitrag zeigt Schritt für Schritt, wie wir ihn eingekreist haben, und warum die Ursache jeden TYPO3-Betreiber mit großen Datenordnern betrifft.
Die Herausforderung
Für die Fehlersuche hatten wir zunächst wenig in der Hand:
- Die Fehlermeldung nennt keinen Aufruf. PHP schreibt nur, dass die Zeit abgelaufen ist, und an welcher Stelle im Code der Abbruch passierte – nicht, welche Seite oder welche Person ihn ausgelöst hat.
- Die genannte Stelle führt in die Irre. Der Abbruch geschah beim Lesen eines Datenbankergebnisses. Das sieht nach einer langsamen Datenbank aus, war es aber nicht.
- Das Zugriffsprotokoll passt nicht. Um 16:30:59 hätte dort ein vierminütiger Aufruf stehen müssen. Es gab keinen.
- Keine Schreibvorgänge. In dem Zeitraum wurde nichts gespeichert, kopiert oder angelegt – frühere Fälle mit ähnlichem Fehlerbild schieden damit aus.
- Kein Mitschnitt für den nächsten Fall. Selbst wenn der Fehler wiederkäme, würde er wieder keine Spur hinterlassen.
Unsere Lösung
1. Zwei Details, die das Rätsel auflösen
Die Erklärung lag in zwei technischen Eigenheiten, die man kennen muss, um solche Protokolle richtig zu lesen.
Erstens: PHP misst unter Linux Rechenzeit, nicht Uhrzeit. Die Grenze max_execution_time zählt die CPU-Zeit, die der Prozess tatsächlich verbraucht hat. Wartet er zwischendurch auf die Datenbank, läuft diese Uhr langsamer als die Wanduhr. 240 Sekunden Rechenzeit können also deutlich mehr als vier Minuten echte Zeit bedeuten. Und die Stelle im Code, die in der Fehlermeldung steht, ist nur der Ort, an dem der Zähler zufällig abgelaufen ist – nicht die Stelle, an der die Zeit verbraucht wurde.
Zweitens: Der Webserver schreibt seine Zeile, wenn er fertig ist – nicht, wenn PHP fertig ist. Verlässt jemand eine Seite, bevor sie geladen ist, notiert der Webserver (nginx) den Statuscode 499 („Client hat die Verbindung geschlossen“) mit der kurzen Zeit bis zum Abbruch und gibt die Verbindung auf. PHP bemerkt davon nichts, solange es keine Ausgabe schreibt – und TYPO3 schreibt erst ganz am Ende. Der Prozess rechnet also weiter, ohne dass irgendjemand auf das Ergebnis wartet.
Mit diesem Wissen haben wir nicht mehr nach einem langen Aufruf gesucht, sondern nach einem kurzen, abgebrochenen Aufruf mehrere Minuten vor dem Absturz. Und tatsächlich:
| Beginn des Aufrufs | 16:23:21 Uhr |
| Redakteur verlässt die Ansicht | nach 3,9 Sekunden (Status 499) |
| PHP wird abgebrochen | 16:30:59 Uhr – rund 7,5 Minuten später |
| Aufgerufene Ansicht | „Verlauf“ eines Ordners im Backend |
Ein Redakteur hatte im TYPO3-Backend die Änderungshistorie eines Ordners geöffnet, nach knapp vier Sekunden nichts gesehen und weitergeklickt. Für ihn war die Sache erledigt. Auf dem Server lief die Anfrage siebeneinhalb Minuten unter Volllast weiter.
2. Damit der nächste Fall eine Spur hinterlässt
Die zeitliche Übereinstimmung war ein starkes Indiz, aber kein Beweis. Bevor wir irgendetwas an TYPO3 geändert haben, haben wir deshalb dafür gesorgt, dass so ein Fehler beim nächsten Mal nicht mehr spurlos bleibt: Wir haben das Slowlog von PHP-FPM eingeschaltet.
Läuft eine Anfrage länger als 60 Sekunden, schreibt PHP-FPM seitdem auf, welches Skript mit welcher Adresse gerade läuft und wo im Code es sich befindet – einen vollständigen Backtrace. Ein paar Punkte, auf die es dabei ankommt:
- Die Schwelle liegt mit 60 Sekunden weit über der normalen Antwortzeit, damit das Protokoll im Alltag leer bleibt.
- Der Container braucht eine zusätzliche Berechtigung, um laufende Prozesse auszulesen. Ohne sie entsteht zwar ein Eintrag, aber ohne Backtrace – und damit ohne den eigentlichen Nutzen.
- Die Datei liegt außerhalb des Containers, übersteht also jedes Update, und wird wie alle anderen Protokolle täglich rotiert.
- Getestet haben wir das mit einer bewusst langsamen Testanfrage, bevor es auf die Produktion ging.
3. Die Ursache: ein Ordner mit 830.000 Datensätzen
Der Ordner, dessen Verlauf der Redakteur geöffnet hatte, ist kein gewöhnlicher Seitenordner. Er heißt „Stammdatenbank“ und enthält den Großteil der Plattformdaten:
- 301.908 Adressen
- 230.979 Abonnements
- 96.773 Verkostungsnotizen
- 85.245 Jahrgänge
- 63.848 Weine
Dazu kommen Preise und Dateiverknüpfungen – zusammen rund 830.000 Datensätze.
Die Verlaufsansicht von TYPO3 zeigt für eine Seite standardmäßig nicht nur die Änderungen an der Seite selbst, sondern auch die aller Unterelemente. Dafür sucht sie in jeder Tabelle alle Datensätze, die in diesem Ordner liegen – auch gelöschte –, und stellt dann für jeden einzelnen davon mehrere weitere Datenbankabfragen: Zugriffsrechte, Seitenrechte, die eigentliche Historie. Bei einer normalen Inhaltsseite mit ein paar Dutzend Elementen ist das kein Problem. Bei 830.000 Datensätzen sind es Millionen Abfragen für einen einzigen Klick.
Ein einziger harmloser Klick eines Redakteurs kann eine Anfrage auslösen, die nie fertig wird.
Jeder Klick auf „Verlauf“ bei diesem Ordner – über das Kontextmenü im Seitenbaum oder die Schaltfläche in der Listenansicht – blockierte einen PHP-Prozess für Minuten. Die Produktion hat 20 davon. Ein paar neugierige Klicks hintereinander, und die Website wird für alle Besucher langsam.
4. Ein Wächter, der nur bei Bedarf eingreift
Die naheliegenden Lösungen haben wir verworfen: Die Zeitgrenze von PHP zu senken, hätte legitime lange Vorgänge im Backend abgebrochen. Den Verlauf für den Ordner komplett zu sperren, hätte den Redakteuren auch die Historie des Ordners selbst genommen. Und den TYPO3-Kern selbst umzuschreiben, hätte bei jedem Update erneut Arbeit verursacht.
Stattdessen haben wir eine kleine Backend-Middleware gebaut, die sich vor die Verlaufsansicht setzt:
- Wird der Verlauf einer Seite aufgerufen, zählt sie zuerst, wie viele Datensätze darin liegen – und hört bei 5.000 auf zu zählen. Bei kleinen Seiten kostet das praktisch nichts, bei großen Ordnern ist die Antwort nach wenigen Abfragen klar.
- Liegen 5.000 oder mehr Datensätze darin, werden die Unterelemente nur für diese eine Anfrage ausgeblendet. Eine Hinweismeldung „Unterelemente ausgeblendet“ erklärt, warum.
- Die gespeicherte Einstellung des Redakteurs bleibt unberührt. Wer bei anderen Seiten die Unterelemente sehen möchte, sieht sie dort weiterhin. Selbst wenn jemand im großen Ordner den Schalter für Unterelemente aktiviert, wird das nicht gegen seine eigenen Einstellungen gespeichert.
- Die Historie eines einzelnen Datensatzes – einer Adresse, eines Weins – ist wie bisher direkt am Datensatz abrufbar.
Beim Nachbauen der Logik des TYPO3-Kerns haben wir noch eine Lücke gefunden: Die Verlaufsansicht kann ihr Ziel nicht nur über den Namen der Seite bekommen, sondern auch über die Nummer eines einzelnen Historieneintrags (den Parameter historyEntry). Ohne Gegenmaßnahme hätte man den Wächter auf diesem Umweg umgehen können. Auch dieser Weg ist abgedeckt.
Die Lösung ist mit automatisierten Tests abgesichert, die genau diese Fälle prüfen: andere Seiten bleiben unberührt, die Einstellung wird nach der Anfrage wiederhergestellt – auch wenn dabei etwas schiefgeht –, und gespeicherte Einstellungen werden nicht überschrieben.
Der zweite Absturz an diesem Nachmittag, vier Sekunden nach dem ersten, passt übrigens nicht zu dieser Ursache. Wir haben ihn nicht passend gemacht, sondern offen gelassen – dank des Slowlogs wird er, falls er wiederkommt, diesmal eine Spur hinterlassen.
Das Ergebnis
- Der Verlauf des großen Datenordners lädt in rund 0,5 Sekunden – statt nach Minuten abzubrechen.
- Kein PHP-Prozess wird mehr minutenlang blockiert, nur weil jemand im Backend auf „Verlauf“ klickt.
- Kleine Seiten und Ordner verhalten sich wie bisher, inklusive Unterelementen.
- Keine Änderung an den Einstellungen der Redakteure und keine Änderung am TYPO3-Kern – die Lösung übersteht Updates.
- Der nächste Geisterfehler hinterlässt eine Spur: Jede Anfrage, die länger als eine Minute läuft, wird mit Adresse und Backtrace protokolliert.
Fazit
Die Fehlermeldung sagte „Datenbank“, das Protokoll sagte „nichts“, und beides war irreführend. Erst das Wissen, wie PHP Zeit misst und wann der Webserver protokolliert, hat den Blick auf die richtige Stelle gelenkt: einen Aufruf, der nach vier Sekunden abgebrochen schien, aber minutenlang weiterlief.
Die eigentliche Lehre geht über diesen Einzelfall hinaus: Wer große Datenordner in TYPO3 hat, sollte wissen, dass Standardfunktionen des Backends für solche Mengen nicht gebaut sind – und dass ein ganz normaler Klick zur Last für die ganze Website werden kann. Gute Fehlersuche heißt deshalb nicht nur, die Ursache zu finden, sondern auch dafür zu sorgen, dass der nächste Fehler nicht wieder spurlos bleibt.