Wenn eine TYPO3 Website nicht funktioniert, ist die erste Reaktion meistens dieselbe: Was ist passiert?
Vielleicht erscheint nur noch eine weiße Seite. Vielleicht kommt ein 500-Fehler. Das Backend lässt sich nicht mehr öffnen, eine einzelne Unterseite funktioniert nicht oder nach einem TYPO3 Update ist plötzlich die gesamte Website offline.
Das Problem: Von außen ist häufig nicht erkennbar, wo die Ursache liegt.
TYPO3 selbst ist nur ein Teil der technischen Umgebung. Eine Website besteht aus dem TYPO3 Core, Extensions, individuellen Entwicklungen, Templates, Datenbank, PHP und Server. Dazu kommen je nach Projekt noch externe Schnittstellen und weitere technische Abhängigkeiten.
Deshalb sollte eine defekte TYPO3 Website nicht einfach auf Verdacht verändert werden.
Der erste Schritt ist eine saubere Eingrenzung: Was genau funktioniert nicht mehr und wann ist das Problem erstmals aufgetreten?
Die Website ist komplett nicht erreichbar
Wenn beim Aufruf der Domain gar keine Website mehr erscheint, muss zunächst zwischen einem TYPO3- und einem Serverproblem unterschieden werden.
Ein Browser kann beispielsweise einen 500-, 502- oder 503-Fehler anzeigen. Auch eine Zeitüberschreitung ist möglich. In anderen Fällen wird eine TYPO3-Fehlermeldung ausgegeben.
Diese Unterschiede sind wichtig.
Ein HTTP-500-Fehler kann beispielsweise durch einen PHP-Fehler verursacht werden. Ein 502-Fehler kann auf ein Problem bei der Kommunikation zwischen Webserver und PHP-Prozess hindeuten. Ein 503-Fehler kann bedeuten, dass ein Dienst aktuell nicht verfügbar ist.
Wenn dagegen eine TYPO3-spezifische Fehlermeldung erscheint, liegt die Ursache möglicherweise innerhalb der Anwendung.
Das bedeutet: Bevor TYPO3 selbst untersucht wird, sollte geklärt werden, ob der Server die Anwendung überhaupt korrekt ausführt.
TYPO3 Website zeigt nur eine weiße Seite
Eine weiße Seite gehört zu den unangenehmsten Fehlerbildern, weil der Besucher kaum Informationen erhält.
Technisch kann trotzdem sehr viel dahinterstecken.
Ein PHP-Fehler kann die Ausgabe unterbrechen. Eine Extension kann einen Fehler verursachen. Ein Template kann nicht mehr korrekt verarbeitet werden oder eine individuelle Entwicklung kann mit der aktuellen TYPO3- beziehungsweise PHP-Version nicht kompatibel sein.
Gerade bei älteren TYPO3 Websites sollte deshalb nicht sofort davon ausgegangen werden, dass die gesamte Installation beschädigt ist.
Häufig ist nur eine bestimmte Komponente die Ursache.
Die entscheidende Information findet sich dann oft nicht im Browser, sondern in den entsprechenden Logs.
TYPO3 Backend funktioniert nicht
Wenn das Frontend funktioniert, das TYPO3 Backend aber nicht mehr erreichbar ist, ist die Situation etwas anders.
Vielleicht funktioniert der Login noch, anschließend erscheint jedoch ein Fehler. Oder ein bestimmtes Backend-Modul lässt sich nicht öffnen.
Das kann beispielsweise durch eine Extension verursacht werden, die eigene Backend-Funktionen bereitstellt.
Auch Änderungen an TYPO3, PHP oder individuellen Backend-Anpassungen können eine Rolle spielen.
Wenn nur ein bestimmter Bereich betroffen ist, sollte deshalb untersucht werden, welche Funktion beim Aufruf dieses Bereichs ausgeführt wird.
Wenn dagegen das gesamte Backend nicht funktioniert, muss die Analyse weiter gefasst werden.
Nur eine einzelne TYPO3 Seite funktioniert nicht
Interessant wird es, wenn nicht die gesamte Website betroffen ist.
Vielleicht funktioniert die Startseite problemlos, während eine bestimmte Unterseite einen Fehler ausgibt.
Das spricht häufig dafür, dass die Ursache mit den Inhalten oder Funktionen dieser Seite zusammenhängt.
Möglicherweise verwendet die Seite ein spezielles Content Element. Vielleicht wird eine individuelle Extension nur dort eingebunden. Eventuell werden bestimmte Daten aus einer Datenbank geladen oder ein eigenes Fluid Template verwendet.
Auch ein fehlerhaftes TypoScript kann dafür verantwortlich sein.
In diesem Fall ist es wenig sinnvoll, die gesamte TYPO3 Installation zu verändern.
Stattdessen sollte zunächst untersucht werden, was diese Seite von den funktionierenden Seiten unterscheidet.
TYPO3 funktioniert nach einem Update nicht mehr
Besonders häufig wird die Frage „Warum funktioniert meine TYPO3 Website nicht mehr?“ nach einem Update gestellt.
Ein TYPO3 Update kann verschiedene Komponenten beeinflussen.
Bei einem größeren Versionssprung können APIs geändert oder entfernt werden. Extensions müssen möglicherweise aktualisiert werden. Individuelle Entwicklungen können angepasst werden. Auch die verwendete PHP-Version kann relevant sein.
Wenn die Website unmittelbar nach einem Update nicht mehr funktioniert, ist der zeitliche Zusammenhang deshalb ein wichtiger Hinweis.
Die Frage lautet dann nicht nur:
Was ist kaputt?
Sondern auch:
Was wurde unmittelbar vorher geändert?
Wenn beispielsweise TYPO3, PHP und mehrere Extensions gleichzeitig aktualisiert wurden, muss die Fehlersuche diese Veränderungen berücksichtigen.
Eine TYPO3 Extension verursacht den Fehler
Extensions erweitern TYPO3 um zusätzliche Funktionen. Bei vielen Websites sind sie unverzichtbar.
Gleichzeitig gehören sie zu den häufigen Ursachen für Probleme.
Eine Extension kann beispielsweise nicht mit der verwendeten TYPO3-Version kompatibel sein. Sie kann veralteten PHP-Code enthalten oder mit einer anderen Extension kollidieren.
Besonders bei älteren Installationen lohnt sich deshalb ein Blick auf die vorhandenen Erweiterungen.
Dabei sollte nicht nur gefragt werden, ob eine Extension installiert ist.
Interessanter ist, ob sie beim Auftreten des Fehlers tatsächlich ausgeführt wird.
Wenn beispielsweise nur eine bestimmte Seite betroffen ist und dort eine spezielle Extension verwendet wird, ergibt sich ein deutlich konkreterer Ansatz für die Fehlersuche.
PHP kann die Ursache sein
TYPO3 benötigt PHP, um ausgeführt zu werden.
Wenn sich die PHP-Version auf dem Server verändert, kann das deshalb direkte Auswirkungen auf eine bestehende TYPO3 Website haben.
Eine alte Website kann beispielsweise jahrelang mit einer bestimmten PHP-Version gelaufen sein. Wird diese Version beim Hosting-Anbieter deaktiviert und durch eine neuere ersetzt, können plötzlich Fehler auftreten.
Das bedeutet nicht automatisch, dass TYPO3 selbst veraltet oder beschädigt ist.
Vielleicht funktioniert der TYPO3 Core mit der neuen PHP-Version problemlos, während eine alte Extension oder individuelle Entwicklung damit nicht mehr zurechtkommt.
Deshalb gehört die PHP-Version zu den ersten Punkten, die bei einer plötzlich ausgefallenen TYPO3 Website überprüft werden sollten.
Datenbankproblem bei TYPO3
TYPO3 verwendet eine Datenbank für zahlreiche Inhalte und Informationen.
Wenn die Verbindung zur Datenbank nicht funktioniert, kann die Website entsprechend nicht korrekt arbeiten.
Auch Änderungen an der Datenbank, fehlerhafte Zugangsdaten oder Probleme mit dem Datenbankserver können deshalb dazu führen, dass eine TYPO3 Website nicht mehr funktioniert.
Bei einer bestehenden Installation sollte allerdings nicht vorschnell direkt in der Datenbank gearbeitet werden.
Eine produktive Datenbank enthält die Inhalte und Strukturen der Website. Unüberlegte Änderungen können zusätzliche Schäden verursachen.
Zuerst sollte deshalb geklärt werden, ob tatsächlich ein Datenbankproblem vorliegt und welche Komponente dafür verantwortlich ist.
Serverproblem statt TYPO3 Problem
Nicht jede defekte TYPO3 Website hat ihre Ursache im CMS.
Der Server kann beispielsweise nicht erreichbar sein, PHP-Prozesse können fehlschlagen oder die Datenbank kann Probleme verursachen.
Auch Ressourcenengpässe können eine Rolle spielen.
Wenn der Server beispielsweise keinen ausreichenden Arbeitsspeicher mehr zur Verfügung hat, kann eine eigentlich funktionierende TYPO3 Website plötzlich Fehler produzieren.
Deshalb sollte bei einer Fehlersuche immer die gesamte Umgebung betrachtet werden.
TYPO3, PHP, Datenbank und Webserver arbeiten zusammen. Fällt eine Komponente aus, kann das Ergebnis wie ein TYPO3 Fehler aussehen.
Was bedeuten 500, 502 und 503?
HTTP-Fehler können bei der ersten Eingrenzung helfen.
Ein 500 Internal Server Error weist allgemein darauf hin, dass der Server die Anfrage nicht erfolgreich verarbeiten konnte. Bei TYPO3 können beispielsweise PHP-Fehler oder Probleme innerhalb der Anwendung dahinterstecken.
Ein 502 Bad Gateway deutet häufig auf ein Problem zwischen Serverkomponenten hin, beispielsweise zwischen Webserver und PHP-Prozess.
Ein 503 Service Unavailable bedeutet, dass der angeforderte Dienst momentan nicht verfügbar ist.
Diese Fehler liefern wichtige Hinweise, sind aber noch keine vollständige Diagnose.
Ein 500er-Fehler sagt beispielsweise nicht automatisch, welche Datei oder Extension den Fehler verursacht.
Dafür müssen weitere Informationen aus Logs und der technischen Umgebung ausgewertet werden.
TYPO3 Logs bei der Fehlersuche
Wenn eine TYPO3 Website nicht funktioniert, sind Logs häufig eine der wichtigsten Informationsquellen.
Dort können Fehler protokolliert werden, die im Browser gar nicht sichtbar sind.
Je nach Problem können beispielsweise PHP-Fehler, TYPO3-Fehler oder Servermeldungen relevant sein.
Das Ziel ist dabei nicht, möglichst viele Logzeilen zu sammeln.
Entscheidend ist, den Fehler zu finden, der zeitlich mit dem Problem zusammenhängt.
Wenn die Website um 10:15 Uhr ausgefallen ist und im Log genau zu diesem Zeitpunkt ein Fehler einer bestimmten Extension auftaucht, ist das deutlich aussagekräftiger als eine alte Warnung von vor mehreren Tagen.
Fehler nach Änderungen am Hosting
Manchmal funktioniert eine TYPO3 Website plötzlich nicht mehr, obwohl am TYPO3 Projekt selbst nichts geändert wurde.
Dann lohnt sich ein Blick auf das Hosting.
Wurde PHP aktualisiert? Hat der Hoster den Server umgestellt? Wurde eine Datenbankversion verändert? Gibt es eine neue Serverkonfiguration?
Gerade bei älteren TYPO3 Websites können solche Änderungen relevant sein.
Eine Website, die jahrelang in einer bestimmten Umgebung betrieben wurde, kann auf Veränderungen reagieren, die für moderne Installationen selbstverständlich sind.
Deshalb sollte bei einem plötzlich auftretenden Fehler immer auch gefragt werden, ob es Änderungen beim Hosting gab.
TYPO3 Website funktioniert nur teilweise
Manchmal funktioniert eine Website nicht komplett oder nur unter bestimmten Bedingungen.
Vielleicht laden normale Seiten, während eine Suche einen Fehler produziert. Vielleicht funktioniert das Frontend, aber ein Formular nicht. Oder nur angemeldete Benutzer sehen einen Fehler.
Solche Unterschiede sind für die Fehlersuche besonders wertvoll.
Sie zeigen, welche Funktion betroffen ist.
Wenn nur die Suche nicht funktioniert, muss nicht die gesamte TYPO3 Installation untersucht werden. Wenn nur ein Formular betroffen ist, kann die Analyse auf die entsprechende Extension oder individuelle Entwicklung konzentriert werden.
Je genauer das Fehlerbild beschrieben werden kann, desto gezielter lässt sich die Ursache finden.
TYPO3 Website funktioniert nach Serverwechsel nicht
Ein Serverwechsel ist eine weitere typische Situation, nach der Probleme auftreten können.
Die TYPO3 Dateien wurden übertragen, die Datenbank wurde importiert – trotzdem funktioniert die Website nicht.
Mögliche Ursachen gibt es viele.
Die PHP-Version kann anders sein. Bestimmte PHP-Erweiterungen können fehlen. Dateirechte können nicht stimmen. Composer-Abhängigkeiten können fehlen. Die Datenbankverbindung kann falsch konfiguriert sein.
Auch Pfade oder Umgebungsvariablen können sich verändert haben.
Ein Serverwechsel sollte deshalb technisch wie eine Migration behandelt werden und nicht nur als Kopieren von Dateien und Datenbank.
Was man bei einer defekten TYPO3 Website nicht tun sollte
Wenn eine Website nicht funktioniert, ist die Versuchung groß, möglichst schnell etwas zu ändern.
Genau das kann die Fehlersuche erschweren.
Wer beispielsweise mehrere Extensions deaktiviert, PHP-Versionen wechselt und gleichzeitig Dateien überschreibt, weiß anschließend möglicherweise nicht mehr, welche Änderung welchen Effekt hatte.
Besser ist eine kontrollierte Vorgehensweise.
Zuerst sollte das Fehlerbild dokumentiert werden. Danach wird die Ursache eingegrenzt. Erst wenn ausreichend Informationen vorhanden sind, sollte eine konkrete Änderung vorgenommen werden.
Bei produktiven Websites ist außerdem ein aktuelles Backup besonders wichtig.
Backup vor Reparaturen
Bevor größere Reparaturen durchgeführt werden, sollte ein funktionierendes Backup vorhanden sein.
Dabei reicht es nicht, nur einzelne Dateien zu sichern.
Bei TYPO3 müssen insbesondere auch Datenbank und relevante Konfigurationen berücksichtigt werden.
Ein Backup ist allerdings nur dann wirklich hilfreich, wenn sich daraus im Notfall auch wieder ein funktionierender Zustand herstellen lässt.
Gerade bei komplexen Websites sollte deshalb bekannt sein, wie ein Restore durchgeführt werden kann.
Wann ein TYPO3 Freelancer helfen kann
Bei einem einfachen Fehler lässt sich die Ursache manchmal schnell finden.
Bei einer gewachsenen TYPO3 Website mit mehreren Extensions, individuellen Entwicklungen und einer älteren technischen Basis kann die Fehlersuche dagegen deutlich komplexer werden.
Ein TYPO3 Freelancer kann die bestehende Installation analysieren und den Fehler systematisch eingrenzen.
Dabei geht es nicht nur darum, die Website möglichst schnell wieder online zu bringen.
Ebenso wichtig ist die Frage, warum der Fehler entstanden ist.
Wenn beispielsweise eine veraltete Extension die Ursache ist, kann es sinnvoller sein, diese dauerhaft zu ersetzen oder zu aktualisieren, statt lediglich einen kurzfristigen Workaround einzubauen.
Bestehende TYPO3 Website reparieren statt neu bauen
Ein Fehler bedeutet nicht automatisch, dass die gesamte Website neu entwickelt werden muss.
Gerade bei etablierten Unternehmenswebsites sind Inhalte, URLs, Templates und individuelle Funktionen bereits vorhanden.
Wenn sich die Ursache des Problems identifizieren lässt, ist eine gezielte Reparatur häufig sinnvoller als ein kompletter Relaunch.
Natürlich kann eine technische Analyse auch ergeben, dass eine Website grundsätzlich modernisiert werden sollte.
Das sollte aber eine bewusste Entscheidung sein.
Ein einzelner Fehler ist zunächst einmal genau das: ein Fehler.
Er ist kein automatischer Beweis dafür, dass die gesamte TYPO3 Installation unbrauchbar ist.
TYPO3 Website funktioniert nicht – systematisch statt auf Verdacht
Wenn eine TYPO3 Website nicht funktioniert, gibt es selten nur eine mögliche Ursache.
TYPO3 selbst, Extensions, PHP, Datenbank, Server, Templates und individuelle Entwicklungen können miteinander zusammenhängen.
Deshalb beginnt eine professionelle Fehlerbehebung nicht mit blindem Austauschen von Dateien, sondern mit einer Analyse.
Was funktioniert noch?
Was funktioniert nicht?
Wann trat der Fehler auf?
Was wurde vorher geändert?
Welche Fehlermeldungen und Logs gibt es?
Und welche technische Komponente ist tatsächlich beteiligt?
Je genauer diese Fragen beantwortet werden, desto schneller lässt sich das Problem eingrenzen.
Eine defekte TYPO3 Website muss deshalb nicht automatisch ein großes Projekt werden. Häufig reicht es, die richtige Ursache zu finden und genau dort anzusetzen.
