TYPO3 „Oops, an error occurred!“: Ursache finden und beheben
Statt der Seite zeigt TYPO3 nur „Oops, an error occurred!“ und einen Code? So finden Sie den eigentlichen Fehler im Log und beheben die häufigsten Ursachen.
Kurz gesagt: „Oops, an error occurred!“ ist die Fehlerseite, die TYPO3 im Produktivbetrieb zeigt, damit Besucher keine technischen Details sehen. Der eigentliche Fehler steht im TYPO3-Log und lässt sich über den angezeigten Code finden. Häufige Ursachen sind eine Extension, die nach einem Update nicht mehr passt, ein Fehler im TypoScript, eine nicht aktualisierte Datenbankstruktur oder eine neue PHP-Version. Oft hilft schon das Leeren aller Caches.
Die Meldung sieht zum Beispiel so aus: „Oops, an error occurred! Code: 20261110093412a1b2c3d4“. Die Variante mit „Code:“ betrifft meist ein einzelnes Inhaltselement, der Rest der Seite wird weiter angezeigt. Bricht die ganze Seite ab, sieht die Fehlerseite etwas anders aus, der Weg zur Ursache ist aber derselbe. TYPO3 verschweigt den Grund absichtlich: Fehlermeldungen mit Dateipfaden und Datenbankdetails gehören nicht vor die Augen von Besuchern.
Die Menünamen beziehen sich auf TYPO3 bis Version 13. In TYPO3 14 wurden einige Backend-Module umbenannt, etwa „Admin Tools“ in „Administration“ bzw. „System“.
Schritt 1: Den Fehler im Log finden
Der Code in der Meldung ist eine Kennung, unter der TYPO3 den vollständigen Fehler in die Logdatei schreibt. Die Logs liegen:
- bei Composer-Installationen in
var/log/, - bei klassischen Installationen in
typo3temp/var/log/.
Öffnen Sie die neueste Datei, meist typo3_….log, und suchen Sie nach dem Code aus der Fehlermeldung. Daneben steht die eigentliche Meldung mit Datei und Zeile. Auch im Backend unter „System → Log“ tauchen viele Fehler auf.
Schritt 2: Fehler vorübergehend anzeigen lassen
Für die Fehlersuche können Sie TYPO3 anweisen, Fehler im Klartext auszugeben, und zwar nur für Ihre eigene IP-Adresse. In den Admin-Werkzeugen unter „Settings → Configure Installation-Wide Options“ setzen Sie im Bereich SYS den Wert devIPmask auf Ihre IP-Adresse und lassen displayErrors auf -1 (Standard). Nur in dieser Kombination sehen ausschließlich Sie die Details. Mit displayErrors = 1 sehen sie alle Besucher.
Vorsicht mit der Voreinstellung „Debug“ unter „Settings → Configuration Presets“: Sie zeigt Fehler allen Besuchern an und gehört nur auf eine Testkopie. Setzen Sie devIPmask nach der Reparatur wieder zurück.
Die häufigsten Ursachen
1. Caches
Nach Updates von TYPO3 oder Extensions liegen manchmal veraltete Dateien im Cache. Leeren Sie unter „Admin Tools → Maintenance“ mit „Flush TYPO3 and PHP Cache“ alle Caches. Kommen Sie nicht ins Backend, löschen Sie per FTP den Inhalt von var/cache/ bzw. typo3temp/var/cache/. TYPO3 baut ihn beim nächsten Aufruf neu auf.
2. Extension nach einem Update
Die häufigste Ursache bei Updates: Eine Extension unterstützt die neue TYPO3-Version noch nicht oder nutzt Funktionen, die entfernt wurden. Im Log stehen dann Pfade wie typo3conf/ext/… oder vendor/… mit dem Namen der Extension. Wie Sie damit umgehen, beschreibe ich in TYPO3-Extension nicht kompatibel.
3. Datenbankstruktur nicht aktualisiert
Neue TYPO3- oder Extension-Versionen brauchen oft zusätzliche Tabellenspalten. Fehlen sie, kommt es zu Datenbankfehlern. Prüfen Sie unter „Admin Tools → Maintenance → Analyze Database Structure“ und führen Sie die vorgeschlagenen Änderungen aus. Vorher die Datenbank sichern. Führen Sie zusätzlich unter „Admin Tools → Upgrade“ die Upgrade-Wizards aus, falls welche offen sind.
4. Fehler im TypoScript oder Template
Betrifft der Fehler nur bestimmte Seiten oder Inhaltselemente, ist oft TypoScript oder ein Fluid-Template schuld, etwa ein falsch geschriebener ViewHelper oder ein fehlendes Partial. Das Log nennt in diesem Fall meist die Template-Datei.
5. Neue PHP-Version
Hat der Hoster PHP umgestellt, laufen ältere TYPO3-Versionen und Extensions oft nicht mehr. Jede TYPO3-Version unterstützt nur einen bestimmten Bereich von PHP-Versionen. Läuft auf dem Server ein neueres PHP, als Ihre TYPO3-Version verträgt, hilft auf Dauer nur ein TYPO3-Update.
6. Fehlende Site-Konfiguration
Nach einem Umzug oder einer Domainänderung findet TYPO3 manchmal keine passende Site-Konfiguration. Prüfen Sie im Backend unter „Site Management → Sites“, ob die Domain mit Protokoll (https://) richtig eingetragen ist.
Wann Sie Hilfe holen sollten
Wenn das Log einen Fehler in einer Extension zeigt, für die es kein Update gibt, wenn das Backend selbst nicht mehr erreichbar ist oder wenn Sie gerade mitten in einem Versions-Update stecken. Bei TYPO3 hängen Fehler oft zusammen, und eine Reparatur an der falschen Stelle macht es nicht besser.
Professionelle Hilfe
Ich finde den Fehler im Log, behebe ihn dauerhaft und prüfe danach Frontend und Backend. Mehr unter TYPO3-Hilfe. Die Analyse kostet 150 € netto, die Behebung typischer Fehler beginnt bei 290 € netto. Steckt hinter dem Fehler eine veraltete TYPO3-Version, ist das TYPO3-Update der richtige Schritt.
