Datenbankfehler in TYPO3 — von keiner Verbindung bis fehlende Spalte.

Drei Fälle unterscheiden.

Die genaue Meldung steht nicht auf der grauen Fehlerseite, sondern in der Protokolldatei auf dem Server — dort lohnt der erste Blick (Weiße Seite).

Keine Verbindung.

Dann läuft gar nichts: weder Frontend noch Backend. Die Zugangsdaten liegen in der Systemkonfiguration im Projektverzeichnis. Prüfe dort Datenbankname, Benutzer, Passwort, Host und Port. Häufige Ursachen:

• Nach einem Umzug stehen dort noch die Daten des alten Servers.
• Passwort geändert im Hosting-Kundenbereich, aber nicht in der Konfiguration.
• Host falsch: Mal ist es der lokale Rechner, mal ein eigener Servername — das unterscheidet sich je Hoster.
• Datenbankserver überlastet oder in Wartung.
• Speicherplatz voll — dann verweigert der Datenbankserver Schreibzugriffe und teils die Verbindung (Webspace voll).
• Zu viele gleichzeitige Verbindungen bei knappen Hosting-Paketen.

Ob die Zugangsdaten stimmen, lässt sich unabhängig von TYPO3 prüfen: Melde dich mit denselben Daten in der Datenbankverwaltung des Hosters an. Klappt das nicht, liegt es nicht an TYPO3.

Fehlende Spalten und der Abgleich.

Der mit Abstand häufigste Fall. TYPO3 und seine Extensions erwarten eine bestimmte Datenbankstruktur. Nach einem Update oder nach der Installation einer Extension fehlen Felder oder ganze Tabellen, bis der Abgleich ausgeführt wurde. Symptome sind Meldungen über unbekannte Spalten, leere Listen oder Formulare, die nicht speichern.

Im Admin-Werkzeug gibt es dafür den Datenbankabgleich: Er zeigt die Unterschiede zwischen erwartetem und tatsächlichem Zustand und bietet an, sie anzugleichen. Dabei zwei Dinge beachten. Erstens: Vorschläge zum Löschen von Feldern oder Tabellen sind getrennt aufgeführt und sollten nicht blind bestätigt werden — dort hängen manchmal Daten von Extensions, die nur vorübergehend deaktiviert sind. Zweitens: Vorher ein Backup, weil Änderungen an der Struktur nicht rückgängig zu machen sind.

Beschädigte Tabellen.

Wird ein Schreibvorgang unterbrochen — Serverabsturz, voller Speicher, abgebrochenes Update —, kann eine Tabelle beschädigt zurückbleiben. Typisch ist, dass nur bestimmte Bereiche ausfallen: Der Seitenbaum lädt, aber die Inhalte fehlen; oder das Protokoll-Modul meldet Fehler, während der Rest läuft.

Prüfen und reparieren lässt sich das in der Datenbankverwaltung des Hosters. Bei Tabellen des älteren Typs gibt es dort eine Reparaturfunktion; moderne Installationen nutzen meist einen Typ, der sich beim Neustart des Datenbankservers selbst repariert — dort hilft der Hoster weiter. In beiden Fällen gilt: vorher einen Export ziehen, bevor irgendetwas verändert wird.

Zeichensatz und Umlaute.

Erscheinen Umlaute als Zeichenmüll, passt der Zeichensatz nicht zusammen — zwischen Tabellen, Verbindung und Ausgabe. Das tritt fast immer nach einem Umzug oder einer Wiederherstellung auf, wenn beim Export oder Import eine andere Kodierung verwendet wurde als erwartet.

Wichtig: Das lässt sich nicht durch Umstellen der Anzeige reparieren. Die Daten selbst sind falsch kodiert gespeichert und müssen konvertiert werden — am saubersten durch einen erneuten Import der Sicherung mit korrekter Angabe der Kodierung. Deshalb gehört beim Export immer bewusst gesetzt, mit welchem Zeichensatz gearbeitet wird; moderne TYPO3-Installationen erwarten eine Variante von UTF-8, die auch Sonderzeichen jenseits der Grundmenge abdeckt.

Gewachsene Installationen.

In Installationen, die seit Jahren laufen, sammeln sich erhebliche Datenmengen in Tabellen, die niemand beachtet: Protokolle aller Backend-Aktionen, Verlaufsdaten für die Rückgängig-Funktion, Caches in der Datenbank, Sitzungsdaten und Indexdaten der eingebauten Suche. Millionen Zeilen sind dort keine Seltenheit — und sie machen Backend, Backups und jede Wartung langsam.

TYPO3 bringt dafür geplante Aufräumvorgänge mit, die sich im Scheduler einrichten lassen. In vielen Installationen wurden sie nie aktiviert. Das nachzuholen ist eine der wirksamsten Einzelmaßnahmen überhaupt (TYPO3 langsam).

Aufräumen.

1. Backup ziehen — vor jedem Aufräumen, ohne Ausnahme.
2. Gelöschte Inhalte endgültig entfernen: TYPO3 markiert nur, löscht aber nicht. Im Wartungsbereich lässt sich das bereinigen.
3. Protokoll- und Verlaufstabellen auf einen sinnvollen Zeitraum begrenzen.
4. Verwaiste Datensätze von längst entfernten Extensions prüfen und entfernen.
5. Geplante Aufräumvorgänge einrichten, damit es nicht wieder anwächst.
6. Prüfen, ob der geplante Ablauf überhaupt läuft — ohne regelmäßigen Aufruf vom Server passiert nichts.

Punkt zwei überrascht viele: Inhalte, die vor Jahren gelöscht wurden, liegen noch in der Datenbank. Das ist gewollt, damit sich Dinge zurückholen lassen — aber nach einigen Jahren ist es nur noch Ballast, und bei personenbezogenen Daten auch ein Datenschutzthema.

Nach einem Umzug.

Die typische Reihenfolge nach dem Übertragen einer Datenbank: Zugangsdaten in der Konfiguration anpassen, Caches leeren, Datenbankabgleich ausführen, Dateiindex neu aufbauen und die Site-Konfiguration auf die neue Domain prüfen. Werden diese Schritte ausgelassen, entstehen Fehler, die nach allem Möglichen aussehen — fehlende Seiten, fehlende Bilder, leere Listen (Seite nicht gefunden, Bilder fehlen).

Prüfe außerdem die Datenbankversion auf dem neuen Server. Ein Wechsel zwischen verschiedenen Datenbanksystemen oder größeren Versionssprüngen kann dazu führen, dass bestimmte Feldtypen oder Standardwerte anders behandelt werden — das zeigt sich dann beim Abgleich.

Backup und Wiederherstellung.

Ein Backup der Datenbank allein reicht bei TYPO3 nicht: Dateien und Datenbank gehören zusammen, weil der Dateiindex Verweise enthält. Eine Wiederherstellung nur der Datenbank führt zu Einträgen, die auf nicht vorhandene Dateien zeigen — und umgekehrt.

Zur Sicherung gehört deshalb immer beides, möglichst zum selben Zeitpunkt, und abgelegt außerhalb des Servers. Und sie gehört einmal getestet: Ein nie eingespieltes Backup ist eine Annahme, keine Sicherung. Das ist der Punkt, an dem sich im Ernstfall entscheidet, ob ein Zwischenfall eine Stunde oder eine Woche kostet.

Vorbeugen.

• Nach jedem Update: Caches, Datenbankabgleich, Upgrade-Wizard (Update-Fehler).
• Geplante Aufräumvorgänge einrichten und prüfen, dass sie laufen.
• Speicherplatz im Blick behalten, inklusive Datenbankgröße.
• Backups automatisiert und außerhalb des Servers, Wiederherstellung testen.
• Vor größeren Eingriffen eine Kopie der Installation anlegen.

Wenn du nicht weiterkommst.

Wenn die Datenbank Fehler meldet oder nach einem Update Felder fehlen, bringe ich die Struktur wieder in Ordnung. 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.