So debuggen Sie einen 500-Fehler oder eine weiße Seite in PrestaShop

Wenig erschreckt mehr, als den eigenen Shop zu öffnen und eine weiße Seite oder ein knappes „500 Internal Server Error“ zu sehen. Die gute Nachricht: Die Ursache steht fast immer irgendwo geschrieben. In dieser Reihenfolge suchen wir sie.

1. Was hat sich geändert?

Bevor Sie etwas anfassen: Wurde ein Modul installiert oder aktualisiert? Hat sich die PHP-Version beim Hoster geändert? Wurde eine Datei hochgeladen? 80 % der Ausfälle fallen mit einer kürzlichen Änderung zusammen. Gibt es eine, haben Sie schon den ersten Verdächtigen.

2. Den Debug-Modus aktivieren (mit Vorsicht)

In config/defines.inc.php:

define('_PS_MODE_DEV_', true);

Im Debug-Modus zeigt PrestaShop den vollständigen Fehler auf dem Bildschirm statt einer leeren Seite. Tun Sie das nur so lange wie unbedingt nötig: Die Meldung kann jedem Besucher Serverpfade verraten. Reproduzieren Sie es, wenn möglich, auf einer Kopie des Shops statt im Live-Betrieb.

3. Die Logs lesen

• var/logs/: die Logs von PrestaShop und Symfony (prod-AAAA-MM-DD.log). Suchen Sie nach CRITICAL und ERROR.
• Das PHP-Fehlerprotokoll des Hosters (in cPanel meist unter Metriken > Fehler oder als error_log im Stammverzeichnis).
• Das Log des Webservers, wenn die Seite gar nicht erst bei PHP ankommt.

grep -E "CRITICAL|ERROR" var/logs/prod-$(date +%F).log | tail -20

4. Module und Overrides ausschließen

Unter Erweiterte Einstellungen > Leistung können Sie Nicht-PrestaShop-Module und Overrides vorübergehend deaktivieren. Läuft der Shop dann wieder, liegt die Ursache bei einem davon: Reaktivieren Sie sie hälftenweise, bis Sie es gefunden haben.

5. Den Cache leeren, aber richtig

Löschen Sie den Inhalt von var/cache/prod und var/cache/dev, nicht den ganzen Ordner var/cache: In manchen Versionen liegt dort eine Parameterdatei, die PrestaShop zum Starten braucht.

6. Die „weißen Seiten mit 200“

Sie sind die tückischsten: Der Server antwortet korrekt, aber es gibt keinen Inhalt. Die Ursachen, die wir am häufigsten sehen:

• Ein Modul oder eine Firewall auf PHP-Ebene, die die Anfrage mit exit abbricht.
• Eine Funktion, die im PHP des Servers nicht existiert. Zum Beispiel Miniaturen in AVIF erzeugen, wenn die GD-Bibliothek dieses Format nicht unterstützt.
• Erschöpfter Speicher beim Erzeugen einer sehr schweren Seite.

Hier hilft es sehr, die Seite von der Kommandozeile aus mit einer auto_prepend_file auszuführen, die am Ende die zuletzt geladenen Dateien protokolliert: Sie sagt Ihnen genau, wo es stehen geblieben ist.

7. Wenn Sie es haben

Beheben Sie es, deaktivieren Sie den Debug-Modus, leeren Sie den Cache und notieren Sie, was passiert ist. Wenn es das nächste Mal vorkommt, löst es jemand in fünf Minuten statt an einem Nachmittag.