TYPO3 Fehler nach Update: die häufigsten Ursachen und schnelle Hilfe

Eine weiße Seite ist ein Symptom, keine Diagnose: PHP bricht ab, bevor TYPO3 eine Fehlerseite ausgeben kann, und im Produktivkontext wird die Meldung bewusst nicht angezeigt. Die Ursache finden Sie deshalb nur in den Logs. Typische Auslöser sind eine PHP-Version, die Ihre TYPO3-Version nicht unterstützt, und eine Extension, die nach dem Update nicht mehr kompatibel ist. Ein weiterer Auslöser ist ein veralteter Autoloader: Meldet TYPO3 „Class not found“, hilft bei Composer-Installationen der Befehl composer dump-autoload. Ab v14 kommen zwei weitere Ursachen hinzu: eine zu alte Datenbank oder ein PHP-Speicherlimit unter 256 MB. Prüfen Sie diese Punkte der Reihe nach.

Das Install Tool ist unabhängig vom Backend über /typo3/install.php erreichbar, alternativ nutzen Sie die CLI. Sie können also auch dann arbeiten, wenn das Backend gar nicht mehr lädt. Führen Sie von dort die Erste-Hilfe-Schritte in dieser Reihenfolge aus: Caches leeren, Logs ansehen, Database Analyzer, Upgrade Wizards und zum Schluss den Referenzindex. Prüfen Sie außerdem, ob die PHP-Version zur TYPO3-Version passt. Lesen Sie die genaue Fehlermeldung in den Logs, bevor Sie weitere Schritte unternehmen. Sie zeigt meist, ob die Ursache bei der Konfiguration, der Datenbank oder einer einzelnen Komponente liegt.

Nein, nicht nach jedem Update. Patch-Releases enthalten nur Bugfixes und sind bei sauberem Ablauf in rund einer Stunde eingespielt. Minor-Releases sind grundsätzlich abwärtskompatibel. Umfangreiche Upgrade Wizards kommen vor allem bei größeren Versionsupdates vor. Ein Blick ins Install Tool zeigt, ob Wizards offen sind. Falls ja, arbeiten Sie die Liste vollständig ab und prüfen Sie zum Schluss, dass keiner mehr offen ist. Starten Sie einen fehlgeschlagenen Wizard erst erneut, nachdem Sie die Ursache in den Logs geprüft haben.

Ein TYPO3-Update setzen Sie nur mit einer vollständigen Sicherung zurück, die vor dem Update erstellt wurde. Sie besteht aus allen Dateien und einem SQL-Export der Datenbank.

• Spielen Sie Dateien und SQL-Export aus der Sicherung zurück.
• Stellen Sie bei Composer-Projekten den vorherigen Stand der composer.lock wieder her und führen Sie composer install aus. So werden exakt die alten Paketversionen installiert.
• Leeren Sie anschließend die Caches.

Alles, was nach der Sicherung angelegt oder geändert wurde, müssen Sie erneut einpflegen. Prüfen Sie danach mindestens Backend-Login, Templates, Login-Bereiche, Formulare, Suche, Redirects und Schnittstellen.

Fachkundige Hilfe erhalten Sie von der IllusionFACTORY®. Als TYPO3 Gold Member mit eigenen TYPO3-Entwicklern und persönlichen Ansprechpartnern analysieren wir Ihre Installation. Für eine schnelle Eingrenzung halten Sie bitte bereit: die TYPO3-Version vor und nach dem Update, die PHP- und Datenbankversion, ob es sich um eine Composer- oder klassische Installation handelt, die Fehlermeldung mit Exception-Code, die betroffene Extension oder Eigenentwicklung sowie die bereits durchgeführten Erste-Hilfe-Schritte. Senden Sie uns diese Angaben mit einer kurzen Symptombeschreibung. Wir grenzen den Fehler ein und schlagen Ihnen das passende Vorgehen vor.

Wenn Sie nicht mehr ins Backend kommen, leeren Sie die Caches über das Install Tool oder die Kommandozeile. Beide sind unabhängig vom Backend. Im Install Tool melden Sie sich mit dem Install-Tool-Passwort an und leeren dort die Caches. Über die CLI führen Sie den Cache-Befehl von TYPO3 direkt auf dem Server aus, was praktisch ist, wenn Sie Shell-Zugriff haben. Das Leeren verwirft zwischengespeicherte Konfiguration und Templates, die nach dem Update veraltet sein können. Bleibt der Fehler bestehen, lesen Sie als Nächstes die Logs, da die Ursache dann woanders liegt.

Reproduzieren Sie den Fehler gezielt, etwa durch erneutes Aufrufen der betroffenen Seite, und notieren Sie die Uhrzeit. Suchen Sie rund um diesen Zeitpunkt in drei Logs: dem TYPO3-Log, bei Composer-Installationen meist unter var/log/, dem PHP-Fehlerlog und dem Webserver-Log. Die Speicherorte hängen vom Setup ab, im Zweifel kennt Ihr Hoster sie. Mit tail --follow var/log/typo3_*.log lesen Sie neue Zeilen live mit, während Sie die Seite erneut aufrufen. Übernehmen Sie Meldung und Exception-Code wörtlich und suchen Sie damit gezielt in Dokumentation und Changelogs.

Der Database Analyzer gleicht das Datenbankschema mit den Erwartungen von Core und Extensions ab. Er zeigt, welche Tabellen oder Spalten fehlen, und legt sie auf Wunsch an. Ohne ihn können nach einem Update Datenbankzugriffe fehlschlagen oder Backend-Module Fehler melden.

Wann ausführen? Nach jedem Upgrade, direkt nach dem Leeren der Caches und vor den Upgrade Wizards. Auch bei Fehlern nach dem Update ist er Schritt 3 der Ersten Hilfe.

• Hinzufügende Änderungen (fehlende Tabellen und Spalten) führen Sie direkt aus.
• Löschende Änderungen bestätigen Sie erst, wenn Sie geprüft haben, dass keine Extension das Feld oder die Tabelle noch nutzt. Sonst können Inhalte unwiederbringlich verloren gehen.

Da die Datenbank verändert wird, arbeiten Sie nur mit aktuellem Backup.

Der Referenzindex hält fest, welche Datensätze und Dateien miteinander verknüpft sind. Wenn Sie ihn nach einem TYPO3-Update aktualisieren, baut TYPO3 diese Verknüpfungen neu auf.

Das ist sinnvoll, wenn ein veralteter Index Probleme verursacht. Typisch sind:

• Bilder, Dateien oder Verknüpfungen fehlen, obwohl die Datensätze vorhanden sind.
• Verweise zwischen Inhalten werden nicht mehr korrekt angezeigt.

In der offiziellen Reihenfolge nach einem Upgrade folgt der Schritt nach den Upgrade Wizards. Da er die Verweise neu aufbaut, sollten Sie ihn erst ausführen, wenn Database Analyzer und Wizards durchgelaufen sind.

Fehlen nach dem Update Inhalte oder Elemente, läuft die Seite meist noch, aber eine Migration oder ein Template ist betroffen. Typische Ursachen: Nicht ausgeführte Upgrade Wizards, durch die Daten nicht migriert wurden; hier hilft das Abarbeiten der Wizard-Liste im Install Tool. Ab TYPO3 13 sind außerdem Plugins verschwunden, weil die list_type-Registrierungen entfielen. Führen Sie dann den Wizard zur Plugin-Migration (list_type zu CType) aus und nutzen Sie eine v13-kompatible Extension. Ab v14 können zusätzlich Templates oder Scheduler-Aufgaben betroffen sein. Leeren Sie außerdem die Caches und prüfen Sie die Logs. Bei Datenverlust-Risiko oder teilweise durchgelaufener Migration arbeiten Sie nicht auf der Live-Seite weiter, sondern ziehen Fachleute hinzu.

Meist fehlen nach dem Update die Rewrite-Regeln in der .htaccess oder in der Webserver-Konfiguration. Die Startseite wird direkt ausgeliefert, Unterseiten benötigen jedoch die Umschreibung auf TYPO3 und liefern ohne diese Regeln Fehlerseiten. Vergleichen Sie Ihre .htaccess mit der Vorlage der neuen TYPO3-Version und übernehmen Sie die Rewrite-Regeln aus der Vorlage in die .htaccess oder die Webserver-Konfiguration. Ab v14 gehört dort auch die Kompression der HTTP-Antworten hin. Leeren Sie anschließend die Caches und testen Sie mehrere Unterseiten. Bleibt der Fehler bestehen, hilft ein Blick in das Webserver-Log.

Ja, eine nicht passende PHP-Version ist eine häufige Ursache. Typische Folgen sind eine weiße Seite oder ein Fatal Error. Das passiert zum Beispiel, wenn PHP 8.5 mit TYPO3 12 läuft, denn TYPO3 12 wird nur bis PHP 8.4 unterstützt. TYPO3 13 und 14 laufen mit PHP 8.2 bis 8.5. Prüfen Sie die PHP-Version Ihres Servers und gleichen Sie sie mit der Unterstützung Ihrer TYPO3-Version ab. Heben Sie PHP zuerst auf die höchste von Ihrer TYPO3-Version unterstützte Version an und aktualisieren Sie danach TYPO3. Die genaue Fehlermeldung lesen Sie im PHP-Fehlerlog nach.

Eine Extension als Ursache erkennen Sie am Zeitpunkt und an der Fehlermeldung: Brechen Frontend oder Backend direkt nach dem Update ab, ist oft eine inkompatible Extension beteiligt. Nennen Pfad oder Klassenname in der Fehlermeldung eine Extension, ist sie der wahrscheinliche Verursacher. Deaktivieren Sie Extensions nacheinander und testen Sie nach jedem Schritt, ob der Fehler verschwindet. Prüfen Sie dann die Kompatibilität mit Ihrer TYPO3-Version und spielen Sie die passende Herstellerversion ein. Ab v14 braucht jede Extension eine gültige composer.json; fehlt sie, ist das ein klarer Hinweis auf die Ursache.

Das bedeutet, dass Ihre Templates ab TYPO3 v14 mit Fluid 5 laufen, und Fluid 5 prüft die Datentypen strikter. Erhält ein ViewHelper-Argument einen falschen Datentyp, löst das einen Template-Fehler aus. Meist betrifft das einzelne Inhaltselemente, auch eigene ViewHelper können betroffen sein. Die Fehlermeldung nennt das betroffene Template und Argument. Stellen Sie die Werte in Ihren Templates auf den erwarteten Datentyp um. Bei Extbase-Code gilt zusätzlich: Annotations werden zu PHP-Attributen und müssen entsprechend umgestellt werden.

Zeigt der Scheduler nach dem Update keine Aufgaben mehr an, ist das meist kein Datenverlust, sondern ein Hinweis auf ein Versionsproblem. Betroffen ist vor allem das Update auf v14: Dort laufen Scheduler-Aufgaben mit leerem tasktype nicht mehr. Importe oder Versand stoppen dann unbemerkt. Prüfen Sie die Aufgabenliste im Scheduler und legen Sie Einträge mit leerem tasktype neu an. Führen Sie außerdem die offenen Upgrade Wizards im Install Tool aus, denn der Wizard migriert die übrigen Aufgaben. Steht ein Datenverlust-Risiko im Raum, ziehen Sie besser Fachleute hinzu.

Nein, beheben Sie Fehler besser nicht direkt auf der Live-Seite. Jeder weitere Eingriff am Live-System kann den Ausfall verlängern oder den Zustand verschlimmern, vor allem bei Datenbankänderungen oder einer nur teilweise durchgelaufenen Migration.

Gehen Sie stattdessen so vor:

• Sichern Sie zuerst den letzten funktionierenden Stand, also Dateien und SQL-Export.
• Stellen Sie den Fehler auf einer Kopie der Website nach und prüfen Sie dort die Ursache anhand der Logs.
• Testen Sie die Korrektur auf der Kopie und spielen Sie sie erst danach kontrolliert auf das Live-System ein.
• Debug-Modus und Development-Kontext gehören nie in den Produktivbetrieb.

Bei Datenverlust-Risiko oder ausgefallener Live-Seite sollten Fachleute übernehmen.

Die IllusionFACTORY® geht bei Fehlern nach einem TYPO3-Update in drei Schritten vor. Erstens die Analyse: Wir untersuchen Ihre Installation, werten die Logs aus und grenzen die Ursache ein. Zweitens die Behebung auf einer Kopie: Wir beheben den Fehler zunächst auf einer Kopie Ihrer Website, nicht direkt am Live-System, und prüfen die Korrektur dort. Drittens das kontrollierte Einspielen: Die geprüfte Korrektur übertragen wir anschließend gezielt auf die Live-Seite. So bleibt Ihre Website während der Fehlersuche unangetastet, und Änderungen gehen erst nach erfolgreicher Prüfung live.

Das Update auf TYPO3 14 LTS bietet die IllusionFACTORY® derzeit zum Aktionspreis ab 1.200 € zzgl. MwSt. an. Dies ist ein Einstiegspreis, kein Festpreis für jede Website.

Den Endpreis nennen wir nach einer individuellen Prüfung Ihrer Website. Er hängt vor allem vom Aufwand ab, den Ihre Installation verursacht:

• Größe und Komplexität der Website
• Anzahl und Kompatibilität der eingesetzten Extensions
• Eigenentwicklungen, die eine Code-Migration erfordern
• eigene Templates, deren Prüfung meist den größten Aufwand verursacht
• Ausgangsversion und Abstand zu TYPO3 14

Wenn Sie uns Ihre aktuelle TYPO3-, PHP- und Datenbankversion sowie die Extensions nennen, können wir den Aufwand schneller einschätzen.