Der gefürchtete WordPress Fehler: Eine Schritt-für-Schritt-Anleitung, mit der Sie ihn selbst beheben

Kennen Sie dieses Gefühl? Ihr Herz schlägt schneller, der Magen zieht sich zusammen und die Panik steigt auf. Sie möchten Ihre WordPress-Website aufrufen, und anstatt Ihrer liebevoll gestalteten Inhalte sehen Sie nur… nichts. Oder eine kryptische Fehlermeldung. Der berüchtigte White Screen of Death (WSOD), ein interner Serverfehler 500 oder eine Meldung wie „Fehler beim Aufbau einer Datenbankverbindung“ können selbst erfahrene Webmaster in den Wahnsinn treiben. Doch bevor Sie in den Panikmodus verfallen oder horrende Summen für einen Entwickler ausgeben: Atmen Sie tief durch. Viele dieser gefürchteten WordPress-Fehler lassen sich mit etwas Geduld und der richtigen Anleitung selbst beheben.

In diesem umfassenden Leitfaden führen wir Sie Schritt für Schritt durch die häufigsten Ursachen und deren Behebung. Unser Ziel ist es, Ihnen die Werkzeuge und das Wissen an die Hand zu geben, um Ihre Website wieder online zu bringen und zukünftige Katastrophen zu vermeiden. Vertrauen Sie uns, es ist machbar!

Vorbereitung ist alles: Bevor Sie beginnen

Bevor Sie mit der Fehlersuche und -behebung beginnen, ist es unerlässlich, einige Vorbereitungen zu treffen. Diese Schritte können Ihnen im Notfall den Kopf retten und unnötigen Stress ersparen.

1. Das A und O: Ein vollständiges Backup erstellen

Dieser Punkt kann nicht genug betont werden: Erstellen Sie IMMER ein Backup Ihrer WordPress-Website, bevor Sie größere Änderungen vornehmen oder Fehler beheben. Wenn Ihre Website bereits offline ist, ist es vielleicht nicht mehr direkt über das Dashboard möglich. In diesem Fall gibt es andere Wege:

• Über Ihr Hosting-Panel (cPanel, Plesk, etc.): Die meisten Hoster bieten Backup-Funktionen an, mit denen Sie eine vollständige Kopie Ihrer Dateien und der Datenbank herunterladen können.
• Manuell via FTP und phpMyAdmin:
  • Verbinden Sie sich mit Ihrer Website per FTP (z.B. mit FileZilla) und laden Sie alle Dateien aus Ihrem WordPress-Root-Verzeichnis auf Ihren Computer herunter.
  • Greifen Sie über Ihr Hosting-Panel auf phpMyAdmin zu, wählen Sie Ihre WordPress-Datenbank aus und exportieren Sie sie (meist im SQL-Format).

Ein funktionierendes Backup ist Ihre Lebensversicherung. Es ermöglicht Ihnen, den Zustand Ihrer Website wiederherzustellen, falls etwas schiefgeht.

2. Fehlerlokalisierung aktivieren: WP_DEBUG

WordPress verfügt über einen integrierten Debugging-Modus, der oft versteckte Fehler aufdeckt. Indem Sie WP_DEBUG aktivieren, werden Fehlermeldungen direkt auf dem Bildschirm oder in einer Log-Datei ausgegeben, was Ihnen wertvolle Hinweise auf die Ursache des Problems geben kann.

• Verbinden Sie sich via FTP mit Ihrer Website.
• Navigieren Sie zum Root-Verzeichnis Ihrer WordPress-Installation und suchen Sie die Datei wp-config.php.
• Öffnen Sie diese Datei mit einem Texteditor (z.B. Notepad++, Sublime Text).
• Suchen Sie die Zeile define('WP_DEBUG', false);.
• Ändern Sie sie in:

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false); // Schaltet die Anzeige von Fehlern auf der Seite aus, schreibt sie aber in die Log-Datei
  @ini_set('display_errors',0);

Die Einstellung WP_DEBUG_LOG sorgt dafür, dass alle Fehlermeldungen in einer Datei namens debug.log im Ordner wp-content gespeichert werden. WP_DEBUG_DISPLAY auf false zu setzen ist ratsam, damit Besucher Ihrer Website keine Fehlermeldungen sehen, während Sie debuggen. Überprüfen Sie nach dieser Änderung Ihre Website erneut und sehen Sie nach, ob eine Fehlermeldung erscheint oder die debug.log-Datei erstellt wurde.

3. Zugangsdaten bereithalten

Stellen Sie sicher, dass Sie alle benötigten Zugangsdaten griffbereit haben:

• FTP-/SFTP-Zugangsdaten (Host, Benutzername, Passwort, Port).
• Hosting-Kontologin-Daten (für cPanel, Plesk oder ähnliches).
• Datenbankzugangsdaten (Benutzername, Passwort, Datenbankname, Host – diese finden Sie ebenfalls in der wp-config.php-Datei).

Schritt-für-Schritt-Anleitung zur Fehlerbehebung (WSOD & Co.)

Die meisten WordPress-Fehler, insbesondere der WSOD, sind auf eines der folgenden Probleme zurückzuführen: Plugin-Konflikte, Theme-Konflikte, Speicherbegrenzungen oder korrupte Core-Dateien. Gehen Sie diese Schritte systematisch durch.

Schritt 1: Plugins deaktivieren (Der häufigste Übeltäter)

Plugins sind eine der größten Stärken von WordPress, aber auch eine häufige Ursache für Konflikte. Ein kürzlich installiertes oder aktualisiertes Plugin kann der Auslöser sein.

a) Deaktivierung über das WordPress-Dashboard (wenn zugänglich)

Wenn Ihre Website teilweise noch funktioniert und Sie Zugriff auf das Backend haben:

• Gehen Sie zu „Plugins“ > „Installierte Plugins“.
• Deaktivieren Sie alle Plugins.
• Prüfen Sie, ob Ihre Website wieder funktioniert. Wenn ja, reaktivieren Sie die Plugins einzeln und überprüfen Sie nach jeder Aktivierung die Website. So finden Sie das problematische Plugin.

b) Deaktivierung über FTP (wenn Dashboard nicht zugänglich)

Dies ist die Methode der Wahl, wenn Sie den White Screen of Death sehen und keinen Zugriff auf das Backend haben.

• Verbinden Sie sich via FTP mit Ihrer Website.
• Navigieren Sie zu wp-content/.
• Benennen Sie den Ordner plugins um (z.B. in plugins_old). Dadurch werden alle Plugins deaktiviert.
• Prüfen Sie, ob Ihre Website wieder funktioniert.
• Wenn ja: Benennen Sie den Ordner wieder in plugins um.
• Gehen Sie dann in den Ordner plugins und benennen Sie jeden einzelnen Plugin-Ordner um (z.B. pluginname_old), bis Sie den Übeltäter gefunden haben. Reaktivieren Sie die restlichen Plugins und laden Sie das problematische Plugin neu oder suchen Sie nach einer Alternative.

Schritt 2: Theme wechseln (Der zweite Übeltäter)

Nach Plugins sind Themes die zweithäufigste Ursache für Probleme. Insbesondere nach Theme-Updates oder der Installation neuer Themes kann es zu Konflikten kommen.

a) Wechsel über das WordPress-Dashboard (wenn zugänglich)

Wenn Sie Zugriff auf das Backend haben:

• Gehen Sie zu „Design“ > „Themes“.
• Aktivieren Sie ein Standard-WordPress-Theme (z.B. Twenty Twenty-Four, Twenty Twenty-Three).
• Prüfen Sie, ob Ihre Website wieder funktioniert. Wenn ja, liegt das Problem bei Ihrem ursprünglichen Theme. Kontaktieren Sie den Theme-Entwickler oder wechseln Sie zu einem anderen Theme.

b) Wechsel über FTP (wenn Dashboard nicht zugänglich)

Dies ist notwendig, wenn der WSOD Sie vom Dashboard aussperrt.

• Verbinden Sie sich via FTP mit Ihrer Website.
• Navigieren Sie zu wp-content/themes/.
• Benennen Sie den Ordner Ihres aktuell aktiven Themes um (z.B. mytheme_old).
• WordPress sollte automatisch auf eines der Standard-Themes (z.B. Twenty Twenty-Four) umschalten, wenn es verfügbar ist.
• Prüfen Sie, ob Ihre Website wieder funktioniert. Wenn ja, wissen Sie, dass Ihr Theme das Problem ist.

Schritt 3: Arbeitsspeicher erhöhen (Memory Limit Error)

Manchmal sind WordPress-Fehler auf einen erschöpften PHP-Arbeitsspeicher zurückzuführen. Dies äußert sich oft als WSOD oder einer Fehlermeldung, die besagt, dass der Speicher erschöpft ist (Memory Exhausted Error).

• Verbinden Sie sich via FTP mit Ihrer Website.
• Öffnen Sie die wp-config.php-Datei in Ihrem Root-Verzeichnis.
• Fügen Sie kurz vor der Zeile /* That's all, stop editing! Happy blogging. */ die folgende Zeile ein:

  define('WP_MEMORY_LIMIT', '256M');

Dies erhöht den WordPress-Speicher auf 256 MB. Wenn das Problem weiterhin besteht, versuchen Sie höhere Werte wie ‘512M’. Wenn diese Änderung keine Wirkung zeigt, kann es sein, dass Ihr Hosting-Anbieter eine niedrigere Obergrenze setzt. In diesem Fall müssten Sie Ihren Hoster kontaktieren oder versuchen, die php.ini oder .htaccess-Datei anzupassen (php_value memory_limit 256M).

Schritt 4: Korrupte WordPress-Dateien ersetzen (Frische Installation)

In seltenen Fällen können WordPress-Core-Dateien beschädigt werden, sei es durch fehlerhafte Updates, Malware oder Serverprobleme. Das Ersetzen der Core-Dateien durch eine frische Version kann helfen.

• Gehen Sie auf die offizielle WordPress-Website (de.wordpress.org) und laden Sie die neueste Version von WordPress herunter.
• Entpacken Sie die heruntergeladene ZIP-Datei auf Ihrem Computer.
• Verbinden Sie sich via FTP mit Ihrer Website.
• Löschen Sie die Ordner wp-admin und wp-includes auf Ihrem Server.
• Laden Sie die neuen Ordner wp-admin und wp-includes aus der heruntergeladenen WordPress-Version auf Ihren Server hoch.
• Laden Sie alle einzelnen Dateien aus dem Root-Verzeichnis der heruntergeladenen ZIP-Datei hoch und überschreiben Sie dabei die vorhandenen Dateien.
• WICHTIG: Überspringen Sie dabei unbedingt den Ordner wp-content und die Datei wp-config.php. Diese enthalten Ihre Inhalte, Themes, Plugins und Konfigurationen und dürfen nicht ersetzt werden.

Nach dem Hochladen sollten Sie die Dateiberechtigungen überprüfen (siehe Schritt 7).

Schritt 5: Datenbankprobleme beheben (Error Establishing Database Connection)

Ein „Error Establishing Database Connection” ist eine klare Ansage: WordPress kann keine Verbindung zur Datenbank herstellen. Dies liegt meistens an falschen Zugangsdaten, einem Datenbankfehler oder einem überlasteten Datenbankserver.

a) Datenbank-Zugangsdaten in wp-config.php prüfen

Dies ist die häufigste Ursache. Die Daten in der wp-config.php müssen exakt mit denen auf Ihrem Server übereinstimmen.

• Öffnen Sie die wp-config.php-Datei via FTP.
• Suchen Sie die folgenden Zeilen und überprüfen Sie, ob die Werte korrekt sind (Groß- und Kleinschreibung beachten):

  define('DB_NAME', 'datenbankname');
  define('DB_USER', 'datenbanknutzer');
  define('DB_PASSWORD', 'datenbankpasswort');
  define('DB_HOST', 'localhost'); // Oder eine andere IP/Host, die Ihr Hoster vorgibt

• Vergleichen Sie diese Daten mit den Informationen, die Sie von Ihrem Hosting-Anbieter erhalten haben (meist im Hosting-Panel unter „Datenbanken”).

b) Datenbank reparieren

Manchmal können Datenbanktabellen beschädigt werden. WordPress bietet eine eingebaute Reparaturfunktion:

• Öffnen Sie die wp-config.php-Datei.
• Fügen Sie direkt unterhalb der Datenbank-Zugangsdaten die folgende Zeile ein:

  define('WP_ALLOW_REPAIR', true);

• Rufen Sie in Ihrem Browser IhreDomain.de/wp-admin/maint/repair.php auf.
• Sie sehen nun eine Seite mit der Option, Ihre Datenbank zu reparieren oder zu optimieren und zu reparieren. Führen Sie die Reparatur durch.
• WICHTIG: Entfernen Sie die Zeile define('WP_ALLOW_REPAIR', true); aus der wp-config.php, sobald die Reparatur abgeschlossen ist, da sie ein Sicherheitsrisiko darstellen kann.

Schritt 6: .htaccess-Datei prüfen/ersetzen

Die .htaccess-Datei steuert viele Aspekte Ihrer Website, wie Permalinks und Weiterleitungen. Eine fehlerhafte .htaccess kann zu einem Internal Server Error oder Weiterleitungsschleifen führen.

• Verbinden Sie sich via FTP mit Ihrer Website.
• Suchen Sie die Datei .htaccess in Ihrem WordPress-Root-Verzeichnis.
• Benennen Sie sie um (z.B. in .htaccess_old).
• Versuchen Sie, Ihre Website zu laden. Wenn sie jetzt funktioniert, war die .htaccess die Ursache.
• Um eine neue, saubere .htaccess zu generieren: Melden Sie sich im WordPress-Dashboard an (falls möglich), gehen Sie zu „Einstellungen“ > „Permalinks“ und klicken Sie einfach auf „Änderungen speichern“, ohne etwas zu ändern. WordPress erstellt dann eine neue Standard-.htaccess-Datei.

Schritt 7: Dateiberechtigungen prüfen

Falsche Dateiberechtigungen können den Zugriff auf Dateien blockieren und zu Fehlern führen. Standardmäßig sollten die Berechtigungen wie folgt sein:

• Ordner: 755
• Dateien: 644

Überprüfen Sie dies mit Ihrem FTP-Client (Rechtsklick auf Datei/Ordner > Dateiberechtigungen oder CHMOD). Achten Sie darauf, die Option „Unterverzeichnisse einschließen” zu verwenden und „Auf Dateien anwenden” bzw. „Auf Verzeichnisse anwenden” korrekt auszuwählen.

Was tun, wenn alles fehlschlägt?

Wenn Sie alle oben genannten Schritte durchlaufen haben und Ihre Website immer noch nicht funktioniert, gibt es noch zwei Optionen:

1. Kontaktieren Sie Ihren Hosting-Support: Ihr Hoster hat oft Zugriff auf detailliertere Server-Logs und kann Probleme auf Server-Ebene erkennen, die für Sie nicht sichtbar sind. Sie können auch bei der Wiederherstellung eines Backups helfen.
2. Suchen Sie professionelle Hilfe: Ein erfahrener WordPress-Entwickler oder eine Agentur kann tiefgreifende Probleme diagnostizieren und beheben, insbesondere wenn es um komplexe Datenbankprobleme, Malware oder Serverkonfigurationen geht.

Prävention: So vermeiden Sie zukünftige Fehler

Die beste Fehlerbehebung ist die, die man nicht braucht. Hier sind einige Tipps, um zukünftige Probleme zu minimieren:

• Regelmäßige Backups: Planen Sie automatische Backups ein und speichern Sie sie an einem externen Ort. Tools wie UpdraftPlus oder BackWPup können dabei helfen.
• Plugins & Themes nur von vertrauenswürdigen Quellen: Laden Sie diese nur aus dem offiziellen WordPress-Repository, von renommierten Marktplätzen oder von Entwicklern mit gutem Ruf herunter.
• Updates sorgfältig durchführen: Führen Sie Updates für WordPress-Core, Themes und Plugins nicht blind durch. Idealerweise testen Sie Updates zuerst auf einer Staging-Umgebung (einer Kopie Ihrer Website), bevor Sie sie auf Ihrer Live-Site anwenden.
• WP_DEBUG deaktivieren: Wenn Sie die Fehlersuche abgeschlossen haben, stellen Sie sicher, dass Sie define('WP_DEBUG', false); in Ihrer wp-config.php wieder auf false setzen, um keine sensiblen Informationen auf Ihrer Live-Seite anzuzeigen.
• Monitor-Dienste nutzen: Dienste, die Ihre Website 24/7 überwachen und Sie bei Ausfällen sofort benachrichtigen, sind eine gute Investition.
• Website-Wartung: Führen Sie regelmäßige Wartungsarbeiten durch, wie das Löschen alter Plugins/Themes, die Optimierung der Datenbank und das Überprüfen der Server-Ressourcen.

Fazit

Der Moment, in dem Ihre WordPress-Website ausfällt, kann beängstigend sein. Doch wie Sie gesehen haben, sind viele der gefürchteten Fehler mit systematischem Vorgehen und den richtigen Werkzeugen selbst behebbar. Von der Aktivierung von WP_DEBUG über das Deaktivieren von Plugins und Themes bis hin zur Reparatur der Datenbankverbindung – Sie sind jetzt gewappnet, um die meisten Herausforderungen zu meistern.

Denken Sie immer daran: Backups sind Ihr bester Freund. Mit regelmäßiger Wartung und einem grundlegenden Verständnis der Funktionsweise von WordPress können Sie die Verfügbarkeit und Sicherheit Ihrer Website erheblich verbessern. Gehen Sie die Schritte ruhig und methodisch durch, und Ihre WordPress-Website wird bald wieder reibungslos laufen. Sie haben das Zeug dazu!