Weiße Seite — die Meldung gibt es, sie wird nur nicht gezeigt.

Erst einordnen.

Die wichtigste Frage lautet: Was wurde zuletzt geändert? In den allermeisten Fällen liegt die Antwort dort — ein Update, eine neue Erweiterung, eine Serverumstellung, ein Eingriff in Templates.

Das Fehlerprotokoll.

Contao schreibt Fehler in ein Protokollverzeichnis innerhalb des Projekts. Dort liegen Dateien je Umgebung; interessant ist der jüngste Eintrag am Ende der Datei.

Zusätzlich führt der Webserver ein eigenes Protokoll, das beim Hoster im Kundenbereich erreichbar ist. Dort landen Fehler, die auftreten, bevor Contao überhaupt startet — etwa Syntaxfehler oder Speicherüberschreitungen. Wenn das Projektprotokoll leer bleibt, ist das Serverprotokoll die richtige Stelle.

Was du suchst: die letzte Zeile mit einer Fehlermeldung, dazu Datei und Zeilennummer. Das ist in neun von zehn Fällen bereits die Antwort — auch wenn die Meldung technisch klingt, nennt sie die betroffene Datei, und daraus ergibt sich die verursachende Erweiterung.

Fehleranzeige aktivieren.

Wenn kein Protokoll zugänglich ist, lässt sich Contao in einen Modus versetzen, in dem Fehler im Browser angezeigt werden. Das geschieht über eine Umgebungsvariable in der Projektkonfiguration.

Zwei Regeln dazu: nur vorübergehend, und nicht auf einem öffentlich erreichbaren System ohne Zugangsbeschränkung — die Meldungen verraten Pfade, Versionen und manchmal Zugangsdaten. Nach der Fehlersuche sofort zurückstellen (Debug-Modus).

Nach einem Update.

1. Cache leeren, vollständig — das löst einen erheblichen Teil dieser Fälle.
2. Protokoll lesen und die genannte Datei einer Erweiterung zuordnen.
3. Diese Erweiterung deaktivieren oder entfernen und erneut prüfen.
4. Datenbankabgleich prüfen — wurde er ausgeführt?
5. Dateien neu veröffentlichen, falls das Backend ohne Gestaltung lädt.
6. Eigene Templates prüfen, wenn nur einzelne Seiten betroffen sind.

Schritt eins klingt banal und ist der häufigste Treffer: Nach einem Update liegen Verweise auf Dateien im Zwischenspeicher, die es nicht mehr gibt (Cache leeren).

Ohne erkennbaren Anlass.

Wenn nichts geändert wurde und es trotzdem passiert, prüfe der Reihe nach:

• Ist die Festplatte voll? Ein volles Verzeichnis legt jedes System lahm — Protokolle und Zwischenspeicher wachsen (Webspace voll).
• Antwortet die Datenbank? Überlastung oder erreichte Verbindungsgrenze.
• Hat der Hoster etwas umgestellt? PHP-Version, Grenzen, Modulkonfiguration.
• Läuft ein Angriff? Ungewöhnlich viele Zugriffe lassen Grenzen reißen (Protokolle auswerten).
• Ist ein Zertifikat abgelaufen? Erzeugt zwar eine andere Meldung, wird aber verwechselt.

Der erste Punkt ist häufiger, als man denkt, und am schnellsten geprüft. Besonders bei Systemen, deren Protokolle nie aufgeräumt werden.

Der Cache.

Contao arbeitet mit einem Zwischenspeicher, in dem Konfiguration und übersetzte Templates liegen. Ist dieser Zustand widersprüchlich — etwa nach einem Update oder einem abgebrochenen Vorgang — bricht der Seitenaufbau ab.

Das Leeren funktioniert über das Backend, über die Kommandozeile oder notfalls durch Entfernen des Zwischenspeicherverzeichnisses im Dateisystem. Der letzte Weg ist der verlässlichste, wenn das Backend selbst nicht mehr erreichbar ist — danach legt Contao das Verzeichnis neu an.

Achte dabei auf die Dateiberechtigungen: Wird das Verzeichnis unter einem anderen Benutzer neu erzeugt als dem des Webservers, entsteht das nächste Problem.

Dateiberechtigungen.

Der Klassiker nach Umzügen und nach Eingriffen per Dateizugriff. Contao braucht Schreibrechte in bestimmten Verzeichnissen — Zwischenspeicher, Protokolle, Dateiverwaltung, erzeugte Ressourcen.

Typisches Bild: Dateien wurden per Dateiübertragung hochgeladen und gehören nun einem anderen Benutzer als dem, unter dem der Webserver läuft. Dann kann Contao nicht schreiben, und je nach Stelle entsteht eine weiße Seite oder ein stiller Fehler.

Prüfen und korrigieren lässt sich das über die Kommandozeile oder, bei einfacheren Fällen, über die Berechtigungsfunktion des Dateiübertragungsprogramms. Setz dabei keine pauschal weit offenen Rechte — das ist ein Sicherheitsproblem und löst die Ursache nicht (Dateirechte).

Speicher und Laufzeit.

Zwei Grenzen, die zu Abbrüchen führen. Der Arbeitsspeicher je Vorgang reicht nicht — typisch bei Bildverarbeitung, großen Importen, Suchindexaufbau oder beim Aktualisieren der Abhängigkeiten. Oder die maximale Laufzeit wird überschritten.

Beides lässt sich anheben, oft in der Projektkonfiguration oder beim Hoster. Wichtig ist, die Grenze nicht blind zu verdreifachen, sondern zu fragen, warum sie gerissen wird: Ein Vorgang, der plötzlich das Doppelte braucht, hat meist einen Grund (Speicherlimit).

Datenbank.

Wenn die Verbindung nicht zustande kommt, meldet Contao das in der Regel deutlich. Weiße Seiten entstehen eher durch fehlerhafte Strukturen: eine Tabelle, die nach einem Update nicht angepasst wurde, oder eine beschädigte Tabelle nach einem Serverabsturz.

Vorgehen: Datenbankabgleich ausführen und die Vorschläge lesen; bei Verdacht auf Beschädigung eine Prüfung über die Datenbankverwaltung laufen lassen. Vorher sichern (Datenbank reparieren).

Nur das Backend betroffen.

Wenn die Website läuft und nur die Verwaltung nicht, ist der Kreis kleiner: eine Backend-Erweiterung, ein Rechteproblem, ein beschädigter Zwischenspeicher oder eine fehlerhafte Benutzerkonfiguration.

Der schnellste Test ist das Leeren des Zwischenspeichers über das Dateisystem. Hilft das nicht, gezielt Backend-Erweiterungen deaktivieren (Backend-Login).

Der Prüfweg.

1. Was wurde zuletzt geändert?
2. Fehlerprotokoll lesen — Projekt und Server.
3. Cache leeren, notfalls über das Dateisystem.
4. Festplattenplatz prüfen.
5. Fehleranzeige aktivieren, wenn nötig und abgesichert.
6. Erweiterung eingrenzen, die in der Meldung auftaucht.
7. Dateirechte prüfen, besonders nach einem Umzug.
8. Grenzen prüfen: Speicher und Laufzeit.
9. Sicherung einspielen, wenn nichts hilft — und danach die Ursache suchen.

Schritt neun ist kein Scheitern, sondern eine Entscheidung: Bei einem laufenden Geschäft ist eine funktionierende Website wichtiger als die schnelle Erkenntnis. Die Ursachensuche kann danach in einer Kopie stattfinden.

Wenn du nicht weiterkommst.

Wenn nichts mehr geht und du nicht weißt, wo die Meldung steht. Ich finde die Ursache, behebe sie und erkläre dir, was passiert ist. Bei einem laufenden Ausfall hilft der Notfall-Support, dauerhaft begleitet die Contao-Wartung.

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

Wer hilft.

Ich bin Manuel Killert, Webentwickler aus Quakenbrück. Content-Management-Systeme sind mein Fachgebiet — ich arbeite seit Jahren damit, unterrichte das Thema als Dozent und kenne die Systeme nicht nur aus der Anwendung, sondern von innen: Datenmodell, Rechtekonzept, Templating, Erweiterungsarchitektur, Betrieb.

Das ist bei Contao besonders nützlich, weil es auf demselben Unterbau aufsetzt wie andere professionelle Systeme. Wer versteht, wie Abhängigkeitsverwaltung, Zwischenspeicherung und Konfigurationsebenen zusammenspielen, findet Fehler schneller — unabhängig davon, welcher Name über dem Backend steht.

Was du von mir bekommst: eine Diagnose in verständlicher Sprache, eine Behebung, die nicht nur das Symptom wegräumt, und eine ehrliche Einschätzung dazu, ob dein System weiterbetrieben, aktualisiert oder abgelöst gehört. Auch wenn die Antwort lautet, dass alles so bleiben kann.