In breve: WordPress REST API 500 — indica che una richiesta REST raggiunge WordPress ma genera un errore interno durante callback, autenticazione, query o serializzazione della risposta.
Indice dei contenuti
WordPress REST API 500: significato
Le prime ipotesi da verificare per “WordPress REST API 500” sono eccezione PHP nella callback della route; errore database durante la query.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “WordPress REST API 500” compare durante un’operazione ripetibile.
- La funzione coinvolta in WordPress REST API non raggiunge il risultato previsto.
- Il log dell’area WordPress REST API registra un evento nello stesso minuto della prova.
- Il comportamento osservato in WordPress REST API cambia in base a utente, rete, file o configurazione.
Cause probabili
- Eccezione PHP nella callback della route
- Errore database durante la query
- Dato non serializzabile nella risposta
- Plugin che filtra rest_pre_dispatch
Diagnosi passo per passo
- Registrare route metodo e corpo non sensibile
- Leggere debug log e log PHP
- Provare la stessa route con dati minimi
- Controllare risposta prima della serializzazione
- Riprodurre su staging con componenti aggiornati
Log e dati da controllare
- DevTools o risposta REST completa
- WordPress debug.log ed error_log
- log WAF, proxy e server web
Correzioni sicure
- Correggere l’eccezione nella callback
- Gestire errori con WP_Error appropriato
- Normalizzare i dati restituiti
- Ottimizzare query o limiti reali
- Rimuovere filtri incompatibili senza disabilitare la REST API
Verifica finale
- L’endpoint restituisce JSON valido
- Il codice HTTP corrisponde all’esito
- Autorizzazione e nonce arrivano correttamente
- Site Health non segnala lo stesso errore
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- WordPress REST API 401 Unauthorized: cause e soluzioni
- WordPress REST API: corpo JSON non valido
- WordPress REST API rest_no_route: endpoint non trovato
Fonti tecniche
Domande frequenti
Che cosa significa “WordPress REST API 500”?
WordPress REST API 500 — indica che una richiesta REST raggiunge WordPress ma genera un errore interno durante callback, autenticazione, query o serializzazione della risposta.
Da cosa può dipendere “WordPress REST API 500”?
Le cause da verificare per “WordPress REST API 500” sono: eccezione PHP nella callback della route; errore database durante la query; dato non serializzabile nella risposta.
Quali controlli eseguire per “WordPress REST API 500”?
Per diagnosticare “WordPress REST API 500”, controlla nell’ordine: registrare route metodo e corpo non sensibile; leggere debug log e log PHP; provare la stessa route con dati minimi. La soluzione è confermata quando L’endpoint restituisce JSON valido; il codice HTTP corrisponde all’esito.