In breve: WordPress risposta JSON non valida: compare quando l’editor o un plugin attende una risposta REST in formato JSON ma riceve HTML, un redirect, un errore PHP, un blocco WAF o una risposta vuota.
Indice dei contenuti
WordPress risposta JSON non valida
Questa guida approfondisce WordPress risposta JSON non valida con verifiche progressive e reversibili. Non inviare password, cookie, token, chiavi private, codici 2FA o file di configurazione completi nei ticket.
Che cosa significa
L’editor a blocchi usa la REST API per leggere e salvare contenuti. Se `/wp-json/` non funziona, se home e siteurl non sono coerenti o se una regola filtra la richiesta, il salvataggio può fallire.
Il codice HTTP e il corpo della richiesta REST devono essere controllati negli strumenti sviluppatore. Una pagina HTML di login, un 403 o un fatal error possono essere presentati come JSON non valido.
Come riconoscere il problema
- Pubblicazione o aggiornamento fallisce nell’editor.
- La console mostra una richiesta REST con 401, 403, 404 o 500.
- `/wp-json/` non restituisce JSON.
- Il problema nasce dopo HTTPS, migrazione o plugin di sicurezza.
- L’editor classico funziona ma quello a blocchi no.
Cause più frequenti
1. Permalink e rewrite
L’endpoint REST restituisce 404 o la homepage.
2. URL WordPress incoerenti
Protocollo o hostname producono redirect.
3. WAF o ModSecurity
La richiesta JSON viene bloccata.
4. Errore PHP
La risposta contiene warning, notice o fatal error.
5. Autenticazione e nonce
La sessione non è valida o wp-admin è cacheato.
6. Plugin o tema
Un componente modifica REST, output o header.
Diagnosi passo per passo
- Apri DevTools Network. Individua la richiesta fallita e il codice.
- Leggi il corpo risposta. Verifica se è HTML, redirect o errore.
- Testa `/wp-json/`. Controlla indice e route interessata.
- Salva i permalink. Rigenera rewrite dopo backup di.htaccess.
- Controlla home e siteurl. Devono usare hostname e protocollo canonici.
- Esamina log e WAF. Correla orario, endpoint e rule ID.
- Disattiva il componente in staging. Conferma plugin o tema senza compromettere produzione.
Procedura di risoluzione
- Ripristina permalink e rewrite. Correggi.htaccess o regole del web server.
- Allinea HTTP e HTTPS. Configura WordPress, proxy e CDN coerentemente.
- Correggi il fatal error. Intervieni sul file indicato dal log.
- Applica una esclusione WAF mirata. Limitata a route e parametro legittimi.
- Escludi wp-admin e REST autenticata dalla cache. Mantieni la cache pubblica dove appropriato.
- Aggiorna plugin e tema. Rimuovi filtri REST incompatibili.
- Ritesta salvataggio e anteprima. Verifica anche media e metadati.
Guide Xlogic correlate
- WordPress REST API 500 Internal Server Error
- WordPress REST API: corpo JSON non valido
- REST API WordPress non disponibile: diagnosi e ripristino