Résumé de l’article
Le message « Échec de la mise à jour. La réponse n’est pas une réponse JSON valide » apparaît quand l’éditeur de WordPress n’arrive plus à dialoguer correctement avec votre serveur. Dans la grande majorité des cas, la panne se règle sans toucher au code : permaliens à réenregistrer, adresse du site mal configurée, extension de sécurité trop zélée ou pare-feu de l’hébergeur. Voici comment trouver la cause, de la vérification la plus simple à la plus technique, et à quel moment il vaut mieux passer la main.
Vous rédigez une page, vous cliquez sur « Mettre à jour » et, au lieu de la confirmation habituelle, un bandeau rouge s’affiche en haut de l’éditeur : « Échec de la mise à jour. La réponse n’est pas une réponse JSON valide. » Parfois la variante dit « Échec de la publication ». Votre texte est toujours là, mais impossible de l’enregistrer. Cette erreur inquiète beaucoup, alors qu’elle se répare le plus souvent en quelques minutes.
Avant toute chose, copiez votre texte dans un document à part : tant que l’erreur n’est pas corrigée, rien ne garantit qu’il sera sauvegardé.
Que signifie vraiment ce message ?
Depuis l’arrivée de l’éditeur de blocs (Gutenberg), WordPress n’enregistre plus vos contenus en rechargeant la page. L’éditeur envoie vos modifications au serveur par l’intermédiaire de l’API REST, une sorte de guichet interne par lequel l’interface d’administration et le serveur s’échangent des données. Le serveur doit répondre dans un format très structuré appelé JSON, un langage de description de données que l’éditeur sait lire.
Le message signifie donc simplement que la réponse reçue n’était pas lisible : soit le guichet est fermé (la requête a été bloquée), soit la réponse a été « polluée » par autre chose, comme une page d’erreur, une redirection ou un message d’avertissement PHP glissé avant les données. Votre contenu n’est pas en cause, c’est la communication qui est coupée. Si vous préférez confier le diagnostic, notre service de résolution des erreurs WordPress s’en charge à distance.
Ce que nous voyons le plus souvent
Très souvent, l’erreur apparaît juste après un changement : passage du site en HTTPS, migration vers un nouvel hébergeur, installation d’une extension de sécurité ou activation d’un pare-feu chez l’hébergeur. Demandez-vous ce qui a changé sur le site dans les jours précédents, c’est souvent la piste la plus rapide.
Comment réparer l’erreur JSON pas à pas
Suivez les étapes dans l’ordre et testez l’enregistrement d’une page après chacune d’elles. Les premières ne présentent aucun risque, les dernières demandent plus de prudence.
1. Réenregistrer les permaliens
Les permaliens sont la forme des adresses de vos pages (par exemple /contact/ plutôt que /?p=12). Pour les faire fonctionner, WordPress s’appuie sur des règles de réécriture, stockées notamment dans le fichier .htaccess sur les serveurs Apache. Si ces règles sont abîmées, les appels vers l’API REST tombent dans le vide.
Rendez-vous dans Réglages > Permaliens, ne changez rien et cliquez sur Enregistrer les modifications. WordPress régénère alors ses règles. C’est la solution la plus simple, et elle suffit dans bien des cas, notamment après une migration.
2. Vérifier les adresses du site
Dans Réglages > Général, les champs Adresse web de WordPress (URL) et Adresse web du site (URL) doivent correspondre exactement à l’adresse affichée dans votre navigateur. Un site consulté en https mais déclaré en http, ou une version avec « www » d’un côté et sans de l’autre, provoque des redirections qui cassent les réponses de l’API.
Si votre site vient de passer au cadenas, relisez notre article sur le passage de WordPress en HTTPS. Attention : une erreur de saisie dans ces deux champs peut vous empêcher d’accéder à l’administration. Si vous n’êtes pas sûr de vous, notez les valeurs actuelles avant de toucher à quoi que ce soit.
3. Consulter l’outil Santé du site
WordPress intègre un diagnostic dans Outils > Santé du site. L’onglet État teste notamment l’API REST et les requêtes dites « de rebouclage » (le site qui s’appelle lui-même). Si un problème critique mentionne l’API REST, vous tenez une confirmation, et le détail du message oriente vers la cause. Notre guide pour comprendre les erreurs HTTP de WordPress vous aidera à décoder ces codes.
4. Mettre en pause les extensions de sécurité et de cache
Certaines extensions de sécurité proposent de « désactiver l’API REST » ou de la réserver à certains utilisateurs. C’est une mauvaise idée : la documentation officielle de WordPress rappelle qu’il ne faut pas la désactiver, car une partie de l’administration en dépend. Les extensions de cache ou d’optimisation peuvent aussi servir une réponse périmée ou modifier le code renvoyé.
Commencez par regarder les réglages de votre extension de sécurité, puis désactivez une à une les extensions récemment installées ou mises à jour, en testant l’enregistrement après chaque désactivation. Pour éviter d’impacter vos visiteurs, l’extension officielle Health Check & Troubleshooting propose un mode de dépannage qui désactive les extensions et applique un thème par défaut pour votre seule session. Notez la liste de vos extensions actives avant de commencer.
5. Tester avec un thème par défaut
Plus rarement, c’est le thème qui ajoute du contenu indésirable dans les réponses du serveur. Passez temporairement sur un thème par défaut de WordPress (ceux de la famille « Twenty »), de préférence via le mode de dépannage évoqué plus haut, et refaites le test. Si l’erreur disparaît, le coupable est trouvé et il faudra corriger ou mettre à jour le thème.
6. Interroger votre hébergeur sur son pare-feu
Beaucoup d’hébergeurs filtrent les requêtes avec un pare-feu applicatif, un logiciel qui bloque ce qui ressemble à une attaque. Il arrive qu’il prenne pour suspect un contenu parfaitement légitime, comme un article qui contient un extrait de code ou certains mots-clés techniques. Un CDN placé devant le site peut faire de même. Si l’erreur ne survient que sur une page précise, c’est une piste sérieuse : contactez le support de votre hébergeur en indiquant l’heure exacte de l’échec, il pourra retrouver la règle déclenchée dans ses journaux.
7. Lire le journal d’erreurs PHP
Dernière cause fréquente : un avertissement PHP affiché à l’écran. Il s’insère au début de la réponse et la rend illisible pour l’éditeur. Pour le repérer, on active le journal de débogage dans le fichier wp-config.php avec les constantes WP_DEBUG et WP_DEBUG_LOG, et on désactive l’affichage avec WP_DEBUG_DISPLAY. Les erreurs sont alors enregistrées par défaut dans le fichier wp-content/debug.log, comme l’explique la documentation de débogage de WordPress.
Notre article comment voir les erreurs d’un site WordPress détaille la marche à suivre. WordPress déconseille de laisser ces outils actifs sur un site en ligne : désactivez-les dès que vous avez trouvé la ligne fautive. Si le journal parle de fonctions, de fichiers et de numéros de ligne qui ne vous disent rien, c’est le bon moment pour vous arrêter.
À éviter
- Installer l’extension Classic Editor pour « contourner » l’erreur : l’ancien éditeur fonctionne sans l’API REST, mais le problème de fond reste entier et d’autres fonctions de votre site risquent d’en souffrir.
- Désactiver l’API REST pour des raisons de sécurité : l’administration de WordPress en a besoin.
- Modifier le fichier .htaccess ou wp-config.php sans copie de sauvegarde : une seule faute de frappe peut rendre le site inaccessible.
- Laisser le mode débogage actif après coup : il peut exposer des informations techniques sur votre site.
Quand faire appel à un professionnel ?
Si vous avez réenregistré les permaliens, vérifié les adresses et mis en pause les extensions sans résultat, inutile de vous acharner. Les causes restantes touchent à la configuration du serveur, au pare-feu de l’hébergeur ou au code, et une mauvaise manipulation à ce niveau peut transformer une gêne en panne complète.
Chez DépannageWP, nous commençons toujours par un audit gratuit pour identifier la cause, puis nous intervenons à distance, partout en France, du lundi au vendredi, au tarif de 70 € TTC de l’heure (dès 35 € TTC la demi-heure), avec la garantie satisfait ou remboursé. Vous trouverez d’autres pannes courantes et leurs solutions sur notre page Résoudre une panne.
En conclusion :
L’erreur « La réponse n’est pas une réponse JSON valide » fait peur, mais elle traduit presque toujours un problème de communication entre l’éditeur et le serveur, pas un site cassé. Réenregistrer les permaliens et vérifier les adresses du site règlent une bonne partie des cas ; les extensions de sécurité et le pare-feu de l’hébergeur expliquent la plupart des autres. Si l’erreur résiste, confiez-la à notre équipe via notre service de dépannage des erreurs WordPress : nous trouvons la cause et remettons votre éditeur en état de marche.
