Une mise à jour WordPress a échoué ou perturbé votre site : comment le rétablir

Vous avez cliqué sur Mettre à jouret quelque chose ne va plus. La mise à jour a peut-être échoué avec « La mise à jour a échoué » ou « Impossible de créer le dossier ». Elle s’est peut-être terminée, mais le site affiche maintenant une erreur, une mise en page défectueuse ou une fonctionnalité en panne. Les mises à jour sont le moment où les sites WordPress rencontrent le plus souvent un problème et, dans la plupart des cas, il est possible de revenir en arrière.

Ce guide couvre les deux situations : les mises à jour qui ne s’installent pas et celles qui s’installent mais endommagent le fonctionnement du site.

Étape 1 : déterminer ce qui a changé

Notez les mises à jour exécutées et leur heure. Si vous avez mis à jour plusieurs extensions à la fois, le problème vient presque certainement de l’une d’elles. Vérifiez :

• Tableau de bord → Mises à jour et la page Extensions pour repérer les éléments récemment mis à jour.
• Votre boîte e-mail. WordPress envoie un message après les mises à jour automatiques et, après une erreur fatale, un e-mail « Votre site rencontre un problème technique ». Celui-ci désigne généralement l’extension ou le thème et contient un lien vers le mode de récupération.
• Le panneau de gestion de votre hébergement, qui peut conserver un journal des mises à jour automatiques ou des sauvegardes.

Étape 2 : si le site affiche « Indisponibilité temporaire pour cause de maintenance »

WordPress met le site en maintenance pendant une mise à jour et crée un fichier nommé .maintenance à la racine. Si la mise à jour s’interrompt, ce fichier reste en place et le site reste bloqué. Supprimez .maintenance dans le gestionnaire de fichiers ou en SFTP. Notre guide pour débloquer WordPress en mode maintenance détaille cette opération et explique comment terminer la mise à jour interrompue.

Étape 3 : si la mise à jour ne s’est pas installée

Messages fréquents et corrections :

• « Impossible de créer le dossier » ou « Le dossier de destination existe déjà » : une tentative précédente a laissé des fichiers ou WordPress ne peut pas écrire dans le dossier. Vérifiez wp-content/upgrade et supprimez les dossiers résiduels qui s’y trouvent. Si un dossier d’extension existe mais que l’extension est incomplète, supprimez ce dossier et réinstallez l’extension. Les dossiers doivent normalement avoir les permissions 755 et les fichiers 644.
• « Le téléchargement a échoué » ou délais dépassés : le serveur n’a pas pu joindre WordPress.org ou le délai a expiré. Réessayez plus tard, ou téléchargez le fichier ZIP de l’extension et téléversez-le dans Extensions → Ajouter une extension → Téléverser une extension. Les versions récentes de WordPress proposent de remplacer la version installée par celle téléversée.
• « Paquet de mise à jour non disponible » : c’est fréquent avec les extensions et thèmes payants. Vérifiez que votre clé de licence est renseignée et active, ou téléchargez la dernière version depuis votre espace client chez l’éditeur.
• Espace disque : un hébergement plein fait échouer les mises à jour de façon parfois inattendue. Vérifiez l’utilisation du disque dans le panneau de gestion et retirez les anciennes sauvegardes stockées sur le serveur.

Étape 4 : si la mise à jour a perturbé le site

Si vous voyez « Il y a eu une erreur critique sur ce site », un écran blanc ou une erreur 500, utilisez le lien de récupération de l’e-mail WordPress pour vous connecter et désactiver l’extension indiquée. Sans ce lien, désactivez-la sans passer par wp-admin :

1. Ouvrez wp-content/plugins dans le gestionnaire de fichiers ou en SFTP.
2. Renommez le dossier de l’extension que vous venez de mettre à jour, par exemple plugin-name en plugin-name-off.
3. Rechargez le site. S’il fonctionne, vous avez trouvé la cause.

Si vous ne savez pas quelle mise à jour est en cause, suivez notre guide pour corriger l’erreur critique WordPress, qui explique comment lire le journal de débogage et identifier le fichier exact.

Étape 5 : revenir à la version précédente

Une fois l’extension ou le thème en cause identifié, revenez à la version qui fonctionnait :

• Extensions de WordPress.org : installez l’extension gratuite WP Rollback , qui ajoute un lien « Rollback » à chaque extension et permet de choisir une version antérieure. Vous pouvez aussi télécharger les anciennes versions depuis la page de l’extension sur WordPress.org, dans Vue avancée.
• Avec WP-CLI : vous pouvez installer directement une version précise :

wp plugin install plugin-name --version=1.2.3 --force

• Extensions et thèmes payants : de nombreux éditeurs proposent les anciennes versions dans votre espace client. Sinon, contactez leur assistance.
• Restaurer une sauvegarde : si plusieurs éléments ne fonctionnent plus en même temps, restaurer les fichiers et la base de données juste avant la mise à jour est souvent le plus rapide. Attention : une restauration complète supprime les commandes, commentaires et soumissions de formulaires reçus depuis la sauvegarde.

Après le retour en arrière, suspendez les mises à jour automatiques de cette extension (sur la page Extensions , cliquez sur Désactiver les mises à jour auto) jusqu’à la publication d’une version corrigée.

Étape 6 : si la mise en page ou une fonctionnalité est défectueuse

Lorsque le site se charge mais s’affiche mal ou qu’une fonctionnalité ne marche plus, la mise à jour a souvent modifié du code dont dépendent d’autres éléments du site :

• Videz tous les caches : extension de cache, cache serveur, CDN comme Cloudflare et navigateur. Des fichiers CSS ou JavaScript anciens conservés en cache sont la cause la plus fréquente d’un affichage défectueux après une mise à jour.
• Constructeurs de pages : régénérez les fichiers CSS dans les outils du constructeur et mettez ses extensions complémentaires à jour vers des versions compatibles avec sa nouvelle version.
• Thèmes enfants et code personnalisé : si votre thème enfant remplace des fichiers de modèles, la mise à jour du thème parent peut les avoir modifiés. WooCommerce signale les modèles remplacés devenus obsolètes dans WooCommerce → État.
• Consultez la console du navigateur (F12, puis Console) pour repérer les erreurs JavaScript désignant le fichier en cause.

Étape 7 : sécuriser les prochaines mises à jour

• Effectuez une sauvegarde complète avant les mises à jour et conservez une copie hors du serveur.
• Mettez à jour une seule extension importante à la fois et vérifiez les pages et formulaires essentiels après chacune.
• Lisez le journal des modifications pour les changements de version majeurs, comme le passage de 4.x à 5.0.
• Testez d’abord les mises à jour importantes sur une copie de préproduction. De nombreux hébergeurs proposent sa création en un clic.
• Évitez de mettre à jour juste avant une période chargée ou avant une absence.

Quand faire appel à un spécialiste

Demandez de l’aide si le retour à la version précédente ne répare pas le site, si la mise à jour a modifié la base de données (fréquent avec WooCommerce et les extensions d’espace membre), si des commandes échouent dans votre boutique ou si vous n’avez pas de sauvegarde. Un retour en arrière mal préparé peut désynchroniser les données et le code.

Questions fréquentes

Faut-il désactiver les mises à jour automatiques ?

Pas complètement. Les mises à jour de sécurité comptent, et un site obsolète présente davantage de risques qu’une mise à jour occasionnellement défectueuse. Un bon compromis consiste à garder les mises à jour mineures automatiques de WordPress et à mettre à jour vous-même les extensions importantes après une sauvegarde.

Peut-on conserver une ancienne version d’extension sans risque ?

Pour une courte durée, oui. Les anciennes versions peuvent comporter des failles connues. Mettez donc à jour dès la publication d’un correctif par le développeur et consultez les notes de sécurité du journal des modifications.

Pourquoi une mise à jour du thème a-t-elle supprimé mes modifications ?

La mise à jour remplace tous les fichiers du thème. Les modifications faites directement dans celui-ci sont perdues. Placez le code personnalisé dans un thème enfant ou une extension d’extraits de code pour qu’il soit conservé lors des mises à jour.