Der Block-Editor (Gutenberg) lädt nicht

Der WordPress-Block-Editor (Gutenberg) ist der Standardeditor zum Erstellen und Bearbeiten von Beiträgen, Seiten und anderen Inhalten. Wenn der Editor nicht geladen wird, einen leeren Bildschirm anzeigt oder auf dem Ladebildschirm hängen bleibt, liegt wahrscheinlich ein Plugin-Konflikt, eine Theme-Inkompatibilität, ein JavaScript-Fehler oder ein Cache-Problem vor.

Dieser Leitfaden führt Sie durch die häufigsten Ursachen und zeigt Schritt für Schritt, wie Sie den Block-Editor wieder zum Laufen bringen.

Häufige Symptome

Wenn der Block-Editor nicht richtig lädt, können folgende Probleme auftreten:

• Der Editor bleibt auf dem Ladebildschirm hängen.
• Es erscheint ein leerer weißer Bildschirm anstelle des Editors.
• Eine Fehlermeldung wie „Der Editor ist auf einen unerwarteten Fehler gestoßen.“
• Beiträge oder Seiten lassen sich nicht zum Bearbeiten öffnen.
• Editor-Schaltflächen oder Bedienelemente reagieren nicht.
• Benutzerdefinierte Blöcke fehlen oder laden nicht.
• Der Classic Editor funktioniert, der Block-Editor jedoch nicht.
• In Ihrem Browser werden JavaScript-Fehler angezeigt.

Häufige Ursachen

Mehrere Faktoren können verhindern, dass der Block-Editor korrekt geladen wird. Zu den häufigsten Ursachen gehören:

• Veraltete oder inkompatible Plugins.
• Theme-Konflikte.
• JavaScript-Fehler.
• Zwischengespeicherte CSS- oder JavaScript-Dateien.
• Optimierungs-Plugins, die Editor-Assets verändern.
• Browser-Erweiterungen, die mit WordPress interferieren.
• Eine veraltete PHP-Version.
• REST-API-Probleme.
• Beschädigte WordPress-Kerndateien.

Lösung 1: Alle Website- und Browser-Caches leeren

Zwischengespeicherte Dateien sind einer der häufigsten Gründe, warum der Block-Editor nach Änderungen an Ihrer Website nicht mehr lädt.

Leeren Sie alle verfügbaren Caches, einschließlich:

• WordPress-Caching-Plugins.
• Serverseitiger Cache.
• Object Cache (Redis oder Memcached).
• CDN-Cache (z. B. Cloudflare).
• Browser-Cache.

Führen Sie nach dem Leeren des Caches einen Hard Refresh durch:

Windows

Ctrl + F5

macOS

Cmd + Shift + R

Öffnen Sie danach den Block-Editor erneut.

Lösung 2: JavaScript-Optimierung deaktivieren

Performance-Plugins optimieren oft JavaScript, um Ladezeiten zu verbessern. Diese Optimierungen sind zwar hilfreich, können aber manchmal Gutenberg stören.

Deaktivieren Sie vorübergehend Funktionen wie:

• JavaScript-Minifizierung.
• JavaScript-Kombination.
• Verzögertes Laden von JavaScript.
• Verzögerte JavaScript-Ausführung.
• CSS-Optimierung.

Leeren Sie nach den Änderungen den Cache und testen Sie den Editor erneut.

Wenn das Problem verschwindet, aktivieren Sie jede Optimierung einzeln wieder, bis Sie die störende Funktion gefunden haben.

Lösung 3: Alle Plugins aktualisieren

Ein veraltetes Plugin ist eine der häufigsten Ursachen für Probleme mit dem Block-Editor — besonders häufig nach einem WordPress-Core-Update.

Aktualisieren Sie jedes installierte Plugin auf die neueste Version und achten Sie besonders auf Plugins, die:

• benutzerdefinierte Gutenberg-Blöcke hinzufügen.
• den WordPress-Editor verändern.
• WooCommerce erweitern.
• Page-Builder-Funktionen enthalten.
• SEO- oder Performance-Verbesserungen bereitstellen.

Wenn ein Plugin nicht mehr gepflegt wird, sollten Sie es durch eine moderne Alternative ersetzen.

Lösung 4: Vorübergehend das Theme wechseln

Ihr aktives Theme kann veraltetes JavaScript oder Kompatibilitätsprobleme enthalten, die das Laden des Editors verhindern.

Aktivieren Sie vorübergehend ein Standard-WordPress-Theme, zum Beispiel:

• Twenty Twenty-Five
• Twenty Twenty-Six

Wenn der Block-Editor dann funktioniert, verursacht sehr wahrscheinlich Ihr Theme das Problem.

Aktualisieren Sie das Theme oder wenden Sie sich an den Entwickler.

Lösung 5: Auf JavaScript-Fehler prüfen

Die Browser-Konsole kann helfen, herauszufinden, was das Laden des Editors verhindert.

So prüfen Sie JavaScript-Fehler:

1. Öffnen Sie die Seite, auf der der Editor fehlschlägt.
2. Drücken Sie F12, um die Entwicklertools zu öffnen.
3. Wählen Sie den Tab Konsole.
4. Laden Sie die Seite neu.

Achten Sie auf rot markierte Fehler wie:

• JavaScript-Syntaxfehler.
• Fehlende JavaScript-Dateien.
• Fehlgeschlagene API-Anfragen.
• Script-Fehler eines Plugins.

Diese Meldungen weisen oft direkt auf die Ursache des Problems hin.

Lösung 6: Plugins einzeln deaktivieren

Wenn Sie die Ursache nicht finden, deaktivieren Sie alle Plugins und aktivieren Sie sie einzeln wieder.

Nachdem Sie jedes Plugin aktiviert haben:

1. Leeren Sie den Cache Ihrer Website.
2. Laden Sie den Block-Editor neu.
3. Prüfen Sie, ob das Problem zurückkehrt.

Sobald der Editor wieder nicht mehr funktioniert, haben Sie wahrscheinlich das konfliktverursachende Plugin gefunden.

Wenn mehrere Plugins aktiv sind, wenn das Problem auftritt, kann es zwischen ihnen einen Kompatibilitätskonflikt geben.

Lösung 7: Ihre PHP-Version prüfen

Eine veraltete PHP-Version kann in WordPress unerwartete Probleme verursachen, einschließlich Problemen mit dem Block-Editor.

Für beste Leistung und Kompatibilität verwenden Sie eine aktuell unterstützte PHP-Version wie PHP 8.2 oder PHP 8.3.

Wenn Sie nicht wissen, welche PHP-Version Ihre Website verwendet, prüfen Sie Ihr Hosting-Control-Panel oder wenden Sie sich an Ihren Hosting-Anbieter.

Lösung 8: WordPress-Debug-Logging aktivieren

Wenn das Problem weiterhin besteht, aktivieren Sie das WordPress-Debugging, um weitere Informationen zu sammeln.

Fügen Sie die folgenden Zeilen zu Ihrer wp-config.php-Datei hinzu:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Reproduzieren Sie dann das Problem und prüfen Sie die Protokolldatei unter:

wp-content/debug.log

Das Protokoll kann Plugin-Fehler, Theme-Konflikte oder andere Probleme aufdecken, die das Laden des Editors verhindern.

Lösung 9: Die REST API testen

Der Block-Editor verwendet die WordPress REST API, um mit Ihrer Website zu kommunizieren.

Prüfen Sie sie unter:

https://yourdomain.com/wp-json/

Wenn alles korrekt funktioniert, sehen Sie eine JSON-Antwort mit Informationen zu Ihrer WordPress-Installation.

Wenn Sie eine Fehlermeldung erhalten wie:

• 403 Forbidden
• 404 Not Found
• 500 Internal Server Error

ist die REST API möglicherweise blockiert oder falsch konfiguriert.

Häufige Ursachen sind:

• Sicherheits-Plugins.
• Firewall-Regeln.
• Falsche Permalink-Einstellungen.
• Serverkonfigurationsprobleme.
• Deaktivierte REST-API-Funktionalität.

Die Behebung von REST-API-Fehlern stellt häufig den Block-Editor wieder her.

Lösung 10: WordPress-Kerndateien neu installieren

Wenn keine der vorherigen Lösungen hilft, sind Ihre WordPress-Kerndateien möglicherweise beschädigt.

So installieren Sie WordPress neu, ohne Ihre Inhalte zu beeinträchtigen:

1. Gehen Sie zu Dashboard → Aktualisierungen.
2. Klicken Sie auf Aktuelle Version neu installieren.
3. Warten Sie, bis der Vorgang abgeschlossen ist.

Dadurch werden die WordPress-Kerndateien neu installiert, ohne Ihre Beiträge, Seiten, Plugins, Themes oder die Medienbibliothek zu löschen.

Best Practices

So verringern Sie das Risiko von Problemen mit dem Block-Editor in Zukunft:

• Halten Sie WordPress, Themes und Plugins aktuell.
• Entfernen Sie ungenutzte oder nicht mehr gepflegte Plugins.
• Testen Sie größere Updates auf einer Staging-Website, bevor Sie sie auf Ihre Live-Website anwenden.
• Halten Sie Ihre PHP-Version aktuell.
• Leeren Sie nach der Installation von Updates alle Caches.
• Vermeiden Sie die Nutzung mehrerer Plugins, die dieselbe Funktion erfüllen.
• Prüfen Sie Ihre Website regelmäßig auf JavaScript-Fehler, nachdem Sie neue Plugins oder Themes installiert haben.
• Erstellen Sie regelmäßige Backups, damit Sie Ihre Website im Fehlerfall schnell wiederherstellen können.

Wenn Sie diese Best Practices befolgen, sorgen Sie für ein stabiles Bearbeitungserlebnis und verringern die Wahrscheinlichkeit künftiger Probleme mit dem Block-Editor.