Què importa primer: l’editor esperava JSON de la API REST de WordPress, però va rebre quelcom més. L’evidència útil és l’estat de la petició fallida, el cos de la resposta i la URL final.
Què indica realment aquest símptoma
Aquest missatge resumeix al voltant d’una petició REST ha fallat. Pot ser causat per rutes, autenticació, un tallafocs, sortida de PHP, URLs incoherents del lloc o un error del servidor, i cada causa deixa una resposta diferent.
Recull proves abans de canviar res
- Obre les eines del desenvolupador del navegador i Identifica la petició a / wp-json / que falla.
- Registra el seu estat HTTP, el cos de la resposta, cadena de redirecionament i mètode de petició.
- Compara l’adreça del lloc i l’adreça WordPress, inclosos el protocol i el servidor.
- Comprova els registres de PHP, del servidor web i de seguretat en la mateixa data i hora.
Causes més habituals
- Ha fallat la reescriptura: La ruta REST no arriba a index.php, sovint després d’un canvi de migració o de regla de servidor.
- Sortida HTML inesperada: Es retorna un avís de PHP, una pàgina d’accés, una resposta de manteniment o bloqueig de l’WAF en comptes de JSON.
- Autenticació o error nonce: Galetes, pàgines d’editor a la memòria cau o una capa de seguretat poden invalidar la sol· licitud.
- Desajusteu URL: HTTP/HTTPS o la discrepància entre www i sense www pot redirigir la petició API lluny del seu origen esperat.
Seqüència segura de diagnòstic i reparació
- Sol· licita la URL REST que falla directament i confirma si retorna JSON o HTML.
- Corregeix la capa evidenciada per la resposta: regles de reescriptura, configuració URL, error de PHP o regla de tallafoc específica.
- Buit les memòria caues de pàgina, objectes, navegador i CDN perquè l’editor rebi un nonce nou i ruta.
- Repet la mateixa acció de desar mentre observeu el plafó de xarxa i el servidor registres.
Com distingir entre les causes probables
No tractis Ha fallat la reescriptura i Sortida HTML inesperada com a causes equivalents. La ruta REST no arriba a index.php, sovint després d’un canvi de migració o de regla de servidor. En canvi, es retorna un avís de PHP, una pàgina d’accés, resposta de manteniment o bloqueig del WAF en comptes de JSON. Per a distingir- les, useu aquestes dues comprovacions: Obre les eines del desenvolupador del navegador i Identifica la petició a / wp-json / que falla; i registra el seu estat HTTP, el cos de la resposta, cadena de redirecionament i mètode de petició. Amb aquestes dades podràs decidir si convé aplicar la primera acció controlada — Sol · licita la URL REST que falla directament i confirma si retorna JSON o HTML — o si has de conservar l’estat actual i ampliar la investigació.
En un lloc de WordPress en producció, repeteix la petició que falla mentre comprova una pàgina que funciona correctament i l’àrea d’administració. Un error aïllat en una ruta requereix un rollback més acotat que un problema que afecta PHP, la base de dades o totes les peticions. Documenta la data i hora exactes, la URL o transacció afectada, l’últim estat correcte conegut i cada canvi realitzat durant el diagnòstic. Aquest registre permet distingir una reparació reproduïble d’una desaparició temporal del símptoma.
Què no has de fer
No desactivis el tallafocs de la API REST ni la plugin de seguretat de forma global. Identifica la ruta o regla bloquejada exacta i Mantén activa la protecció no relacionada.
Com verificar la reparació
- L’editor desa i actualitza la mateixa entrada dues vegades sense errors.
- La petició REST retorna l’JSON vàlid amb el codi d’èxit esperat.
- En la resposta no apareix cap avís de PHP, redirecció o bloqueig del WAF.
Que el símptoma visible desaparegui no és suficient. Tanca la incidència només quan l’acció original que fallava, el recorregut de negoci relacionat i els registres rellevants confirmin que el problema ha desaparegut.
CRITERI D’INCIDENT WP REPAIR
Reconstrueix la incidència abans de corregir-la
Aquest missatge resumeix al voltant d’una petició REST ha fallat. Pot ser causat per rutes, autenticació, un tallafocs, sortida de PHP, URLs incoherents del lloc o un error del servidor, i cada causa deixa una resposta diferent.
- 1
Obre les eines del desenvolupador del navegador i Identifica la petició a / wp-json / que falla.
- 2
Registra el seu estat HTTP, el cos de la resposta, cadena de redirecionament i mètode de petició.
- 3
Compara l’adreça del lloc i l’adreça WordPress, inclosos el protocol i el servidor.
- 4
Comprova els registres de PHP, del servidor web i de seguretat en la mateixa data i hora.
Què ha de quedar verificat
- l’editor desa i actualitza la mateixa entrada dues vegades sense errors.
- La petició REST retorna l’JSON vàlid amb el codi d’èxit esperat.
- En la resposta no apareix cap avís de PHP, redirecció o bloqueig del WAF.
Fonts tècniques oficials
Aquesta guia explica el diagnòstic. Si la web està afectada ara mateix, la intervenció ha de preservar una via de recuperació i verificar el recorregut real del negoci.
Veure el servei de reparació urgent →SOBRE ESTE SÍNTOMA
Preguntes freqüents d'aquesta guia.
Aquest error vol dir que la meva base de dades està malmesa?+
No. Aquest missatge ve de l’editor de blocs que no pot analitzar la resposta API REST com JSON — no diu res sobre la base de dades. La resposta que va rebre va ser HTML, una redirecció, o una pàgina d’error en comptes de JSON, per la qual cosa la falla es troba en enrutament, autenticació, sortida XQZQX, o un tallafocs, no en les seves dades.
Per què l’error apareix només quan es desen certs missatges, no tots ells?+
Si tan sols les publicacions específiques ho habiliten, la causa és més probable que un ganxo plugin, una gran càrrega útil, o contingut que afecta una regla WAF en aquesta petició REST en particular, en comptes d’una reescriptura global o un desajust URL. Comparar un estalvi fallit amb un que funciona en el mateix lloc redueix això ràpidament.
És segur simplement deshabilitar el tallafocs API REST per a fer que l’error desaparegui?+
No. Desactivar el tallafocs API REST o seguretat plugin elimina globalment la protecció de cada ruta, no només la que està fallant. Identifiqui la petició i regla bloquejada exacta en el seu lloc, i mantingui activa la rest de la protecció.
He corregit l'adreça del lloc i el desajustament de direcció WordPress, per què segueix apareixent l’error?+
Un desajust URL és només una de diverses causes possibles; les altres són falles de reescriptura, sortida HTML inesperada i falles d’autenticació o nonce. Després de corregir les URLs, purgar pàgina, objecte, navegador i caixets CDN perquè l’editor obtingui una nova nonce i ruta, després tornar a provar mentre observa el plafó de xarxa.