Weiße Seite in TYPO3 — „Oops, an error occurred“ sagt nichts.

Die echte Meldung finden.

TYPO3 schreibt zu jedem schweren Fehler eine Datei mit dem vollständigen Verlauf — Meldung, Datei, Zeile und die Aufrufkette. Wo sie liegt, hängt von der Version und der Installationsart ab:

Die Dateien tragen oft einen Zeitstempel im Namen, die neueste ist die relevante. Darin steht in der ersten Zeile, worum es geht — alles Weitere ist die Aufrufkette und für den ersten Blick zweitrangig. Erreicht die Seite den Server gar nicht erst, liegt es tiefer, und das Fehlerprotokoll des Hosters ist die richtige Quelle.

Den Fehlercode nutzen.

Die graue Seite zeigt meist eine lange Zahl als Kennung des Vorfalls. Damit lässt sich die passende Exception-Datei finden — sie trägt dieselbe Kennung im Namen. Das ist der schnellste Weg vom Symptom zur Ursache und der Grund, warum man die Zahl nicht wegklicken sollte, bevor man sie notiert hat.

Zusätzlich enthalten viele TYPO3-Meldungen einen eigenen Fehlercode, der aus einer Zeitangabe besteht. Danach lässt sich gezielt in der offiziellen Dokumentation und in den Foren suchen — anders als bei einer allgemeinen Meldung führt das meist direkt zum passenden Fall.

Cache als erste Maßnahme.

Ein beschädigter oder unvollständiger Cache ist die häufigste Ursache überhaupt, besonders nach einem Update, einem Umzug oder einer Änderung an der Konfiguration. TYPO3 legt dort fertigen Code ab; passt der nicht mehr zum restlichen Stand, bricht die Ausführung ab.

Kommst du noch ins Backend, leerst du den Cache über die Schaltfläche in der Kopfleiste oder vollständig über das Wartungsmodul. Kommst du nicht mehr hinein, geht es per FTP oder SSH: die Inhalte der Cache-Verzeichnisse entfernen. Danach die Seite neu laden. Welche Verzeichnisse das genau sind und was man dabei nicht löschen darf, steht in TYPO3-Cache leeren.

Typische Ursachen.

Die Reihenfolge ist nicht zufällig: Arbeite sie von oben nach unten ab, dann triffst du statistisch am schnellsten.

Extension ausschließen.

Nennt die Meldung einen Pfad unterhalb von typo3conf/ext/, hast du den Verursacher bereits. Kommst du ins Backend, deaktivierst du die Extension im Erweiterungsmanager. Ohne Backend geht es über die Konfigurationsdatei, in der die aktiven Extensions eingetragen sind — bei Composer-Installationen ist der Weg ein anderer als bei klassischen, weil dort die Paketverwaltung den Stand bestimmt.

Das Vorgehen und die Fallstricke dabei stehen ausführlich in TYPO3-Extension-Fehler. Grundregel: Eine Extension, die seit Jahren kein Update bekommen hat, überlebt den nächsten Versionssprung selten.

PHP-Version und Erweiterungen.

Jede TYPO3-Version läuft nur mit bestimmten PHP-Versionen. Stellt der Hoster um — was regelmäßig passiert —, kann eine ältere Installation von einem Tag auf den anderen stehen. Umgekehrt scheitert ein Update, wenn PHP zu alt ist. Die Meldung weist meist deutlich darauf hin, etwa mit einem Hinweis auf eine entfernte Funktion.

Ebenfalls prüfen: die benötigten PHP-Erweiterungen. TYPO3 braucht einige davon, und nach einem Serverwechsel fehlt gelegentlich eine. Das Install-Tool zeigt im Umgebungsbereich, was vorhanden ist und was fehlt — das ist die schnellste Prüfung, die es dafür gibt (Fehler nach dem TYPO3-Update).

Das Install-Tool.

Das Install-Tool ist bei einem Ausfall das wichtigste Werkzeug, weil es auch dann oft noch läuft, wenn die Website und das normale Backend tot sind. Erreichbar ist es über eine eigene Adresse, und der Zugang muss freigeschaltet sein — bei vielen Installationen über eine leere Datei mit einem festgelegten Namen im passenden Verzeichnis, die nach einer Stunde ihre Gültigkeit verliert.

Dort findest du die Umgebungsprüfung, die Cache-Verwaltung, den Datenbankvergleich und die Konfiguration. Wichtig: Der Zugang ist mächtig und sollte entsprechend geschützt sein. Nach getaner Arbeit die Freischaltdatei entfernen.

Kontext umschalten.

TYPO3 kennt verschiedene Betriebsarten. Im Produktivbetrieb bleiben Fehlerdetails verborgen, in der Entwicklungsvariante erscheinen sie direkt im Browser mit vollständiger Aufrufkette. Für eine kurze Fehlersuche lässt sich umschalten — über eine Umgebungsvariable in der Serverkonfiguration.

Zwei Warnungen dazu. Erstens: Auf einer öffentlich erreichbaren Website zeigt das Besuchern Dateipfade und interne Details; die Umschaltung gehört also nur für Minuten eingeschaltet, idealerweise auf eine einzelne Adresse begrenzt. Zweitens: Vergiss nicht, zurückzuschalten. Eine Installation, die dauerhaft im Entwicklungsmodus läuft, ist langsam und gibt zu viel preis.

Danach aufräumen.

• Freischaltung des Install-Tools entfernen.
• Betriebsart zurück auf Produktiv.
• Cache noch einmal vollständig leeren.
• Protokolldateien durchsehen und alte entfernen — sie wachsen sonst still weiter.
• Notieren, was die Ursache war. Beim nächsten Mal ist das die Abkürzung.

Wenn du nicht weiterkommst.

Wenn die graue Seite bleibt und du im Protokoll nicht findest, was gemeint ist, schau ich mir das an. Schreib mir mit Domain, TYPO3-Version und einer kurzen Beschreibung — du bekommst eine ehrliche Einschätzung, ob ich der Richtige bin. Den Überblick über alle Themen gibt TYPO3-Fehler beheben. Wenn sich am Ende herausstellt, dass ein Wechsel die bessere Lösung ist: TYPO3 zu WordPress.

Orientierungswerte, keine Fixpreise — nach einem kurzen Gespräch bekommst du ein Festpreisangebot.

Wer hilft.

Ich bin Manuel Killert, Web-Entwickler aus Quakenbrück. Mein Schwerpunkt liegt auf WordPress — an TYPO3-Installationen arbeite ich dort, wo es um Betrieb und Fehlersuche geht: Ausfälle, Serverthemen, Datenbank, Mailversand, Updates und die Frage, wie es mit einer alten Installation weitergehen soll. Das sind die Probleme, bei denen die Ursache meist nicht im System selbst liegt, sondern darunter. Geht es um tiefe Entwicklung in TYPO3 — eigene Extensions, komplexe Mehrsprachigkeit, große Redaktionssysteme —, sage ich dir das offen und empfehle jemanden, der genau das macht. Ehrlich beraten heißt für mich auch, eine Anfrage abzugeben.