Dieser Leitfaden führt WordPress-Site-Besitzer, Entwickler und Hosting-Support-Mitarbeiter durch die Diagnose und Behebung eines „gültigen JSON-Antwort“-Fehlers.
- Gilt für: WordPress 6.x (Bearbeitung der gesamten Website aktiviert)
- Fehlertext:
Updating failed. The response is not a valid JSON response.
Kurze Zusammenfassung von Was bricht
- WordPress sendet eine REST-API-Anfrage, wenn Sie auf Speichern in einem Vorlagenteil klicken:
POST /wp-json/wp/v2/template-parts/<ID> - Der Server gibt etwas zurück, das KEIN gültiges JSON ist (leer, HTML, 403, 500, usw.).
- Site Editor zeigt das allgemeine Fehler-Popup an.
Da der Fehler serverseitig auftritt, kann er auch durch eine client-seitige Aktualisierung nicht behoben werden. Sie müssen den Blocker auf Serverebene, der während der Migration eingeführt wurde, identifizieren und entfernen.
Symptome, die Sie sehen können
| Symptom | Details |
|---|---|
| Fehler modal | „Aktualisierung fehlgeschlagen. Die Antwort ist keine gültige JSON-Antwort.“ |
| Plugins ausgeschlossen | Die Deaktivierung aller Plugins ändert das Ergebnis nicht. |
| Front-End nicht beeinträchtigt | Die Live-Site wird problemlos wiedergegeben, nur das Speichern im Site Editor schlägt fehl. |
| Gestartet nach der Migration | Die Website funktionierte in der Testphase, ging aber sofort kaputt, als sie online ging. |
Baseline Checks (bereits durchgeführt)
Dies sind häufige Schuldige, die bereits ausgeschlossen wurden. Wiederholen Sie sie, wenn Sie von Grund auf neu arbeiten.
- Plugin-Konflikt – deaktivieren Sie alle Plugins.
- Site Health – Tools → Site Health zeigt keine kritischen Fehler im Zusammenhang mit der REST API.
- URL-Konsistenz – Einstellungen → Allgemein → sowohl WordPress-Adresse als auch Website-Adresse verwenden https und identische Domain.
- Permalinks bündig – Einstellungen → Permalinks → Änderungen speichern (regeneriert
.htaccess). - Cache leeren – löschen Sie alle Server-, Plugin- und CDN-Cache-Ebenen.
Wenn der Fehler weiterhin auftritt, fahren Sie mit dem nächsten Abschnitt fort.
Schritt-für-Schritt-Vertiefung
Tipp: Führen Sie jeden Schritt aus und testen Sie dann erneut das Speichern. Hören Sie auf, sobald der Fehler verschwindet.
1 Sammeln Sie Server-Fehlerprotokolle (am aufschlussreichsten)
Fragen Sie Ihren Hoster (z.B. GoDaddy) nach den PHP-Fehlerprotokolleinträgen, die genau dem Zeitpunkt entsprechen, an dem Sie auf Speichern klicken. Geben Sie ihnen einen Zeitstempel (einschließlich Zeitzone). Suchen Sie nach:
- Schwerwiegende PHP-Fehler oder -Warnungen in
/wp-json/Anfragen mod_security/ WAF-Regeln, die REST-Endpunkte blockieren- Meldungen über verweigerte Berechtigungen oder fehlende Dateien
2 Aktivieren Sie die lokale WP-Debug-Protokollierung
Wenn Sie wp-config.php bearbeiten können, fügen Sie oberhalb der Zeile / That’s all, stop editing /ein:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Reproduzieren Sie den Fehler, laden Sie dann /wp-content/debug.log herunter und überprüfen Sie es.
3 REST-API-Endpunkt direkt verifizieren
Führen Sie aus (oder bitten Sie Ihren Host, dies zu tun): curl -I https://your-domain.com/wp-json/wp/v2/
Eine gesunde Website sendet HTTP 200 und JSON-Header zurück. Ein 403/500 deutet auf eine Server- oder Firewall-Blockade hin.
4 Datei- und Verzeichnisberechtigungen prüfen
Migrationswerkzeuge schränken die Berechtigungen gelegentlich zu weit ein.
- Verzeichnisse: 755
- Dateien: 644 Stellen Sie sicher, dass
/wp-content/themes/und/wp-content/uploads/diese Regeln befolgen.
5 Vergleichen Sie .htaccess (oder die nginx-Konfiguration)
Suchen Sie nach Regeln, die /wp-json/ versehentlich blockieren oder umschreiben. Wenn Sie den Apache verwenden, benennen Sie .htaccess vorübergehend um; wenn WordPress die Daten speichert, ist eine Regel darin der Übeltäter.
6 Sicherheitsmodule vorübergehend deaktivieren
Auf vielen Hosts läuft mod_security oder eine Web Application Firewall (WAF).
- Bitten Sie den Host, mod_security für Ihre Domain zu deaktivieren und testen Sie erneut.
- Wenn der Fehler verschwindet, nehmen Sie die betreffende Regel in die Whitelist auf oder passen Sie die Firewall an.
7 Prüfung der Datenbankintegrität (selten, aber möglich)
Vorlageteile leben in wp_posts mit post_type = 'wp_template_part'.
- Suchen Sie die Zeile.
Wenn sie beschädigt ist, kann WordPress durch Löschen die Vorlage neu erstellen und den Fehler beheben.
7. Entfernen Sie alle Emojis und Sonderzeichen
Bei einigen Hosts kann der Fehler auftreten, wenn Sie Emojis oder spezielle Symbole verwenden.
Eskalationsskript für Ihren Hosting-Anbieter
Kopieren Sie das Folgende und fügen Sie es in Ihren Support-Chat/das Support-Ticket ein:
Wir haben unsere WordPress-Blocktheme-Website am [DATUM] migriert. Unmittelbar danach wird nur die Vorlage Site Editors mit der Fehlermeldung nicht gespeichert: „Aktualisierung fehlgeschlagen. Die Antwort ist keine gültige JSON-Antwort.“ Plugin-Konflikte, Permalink-Flush und Site Health sind alle in Ordnung. Bitte überprüfen Sie die PHP-Fehlerprotokolle des Servers und alle WAF/mod_security-Regeln, die
POST /wp-json/wp/v2/template-parts/*blockieren könnten. Überprüfen Sie auch die Dateiberechtigungen (Uploads/Themes) und ob die REST-API erreichbar ist. Das Problem trat vor der Migration nicht auf, daher vermuten wir eine Blockade auf Serverebene oder eine Fehlkonfiguration.
Vorbeugung einer Wiederholung bei zukünftigen Migrationen
| Punkt der Checkliste | Warum es hilft |
| Verwenden Sie eine aktuelle PHP-Version (≥ 8.1) | Ältere Versionen haben REST-Fehler, die in späteren Versionen behoben wurden. |
| Migrieren Sie über ein Plugin (z.B. Duplicator) oder SSH rsync, nicht über „Klonen“-Schaltflächen des Hosts | Stellt sicher, dass die DB vollständig durchsucht und ersetzt wird und die Berechtigungen erhalten bleiben. |
| Überprüfen Sie REST-API-Endpunkte vor und nach der DNS-Umstellung | Fängt JSON-Probleme frühzeitig ab. |
| Bewahren Sie die Serverprotokolle für 48 Stunden nach der Inbetriebnahme auf. | Ermöglicht ein schnelles Rollback oder gezielte Korrekturen. |
Zusätzliche Ressourcen
- WordPress-Handbuch: REST API Fehlerreferenz
- Core Ticket #52527 – Generischer JSON-Antwortfehler ohne Kontext (warum die Meldung so vage ist)
- GoDaddy Hilfe: Fehlerprotokolle in cPanel anzeigen
Immer noch festgefahren?
Wenn Sie alle Schritte befolgt haben und WordPress immer noch nicht speichert und Ihr Hoster die blockierte Anfrage nicht identifizieren kann, ziehen Sie in Betracht:
- Vorübergehender Wechsel zu einem Standard-Blockthema (Twenty Twenty-Four), um zu testen, ob das Problem themenspezifisch ist.
- Beauftragen Sie einen WordPress-Entwickler mit der Überprüfung des Servers in Echtzeit.
Schreibe einen Kommentar