Problème de mise à jour WordPress : que faire pour le résoudre ?

Si une mise à jour WordPress pose problème, commencez par sauvegarder les fichiers et la base de données, puis identifiez le symptôme avant de relancer quoi que ce soit. Un message de maintenance, une erreur serveur ou un écran blanc ne se corrigent pas nécessairement de la même façon. Isolez ensuite les extensions et le thème, puis vérifiez l’environnement d’hébergement.

Premiers réflexes après une mise à jour WordPress ratée

Évitez de relancer la mise à jour plusieurs fois ou de modifier plusieurs réglages à la fois. Vous risqueriez de compliquer le diagnostic sans savoir quelle action a changé le comportement du site.

Vérifiez d’abord si le problème concerne tous les visiteurs ou seulement votre navigateur. Ouvrez le site dans une fenêtre privée et, si possible, depuis un autre appareil. Un cache navigateur, un cache d’hébergement ou un CDN peut afficher une ancienne version de la page alors que le site a changé.

Notez ensuite ce que vous observez et à quel moment le problème apparaît :

• message de maintenance qui reste affiché ;
• page blanche ou erreur 500, 502 ou 503 ;
• boucle de connexion ou administration inaccessible ;
• éditeur bloqué, affichage cassé ou lenteur inhabituelle ;
• message d’incompatibilité après la mise à jour d’une extension ou d’un thème.

Si vous pouvez accéder à l’hébergement, réalisez une copie des fichiers et de la base de données avant toute intervention. Même si le site est déjà en panne, cette copie permet de conserver son état actuel et de récupérer des contenus si nécessaire.

Pour une vue d’ensemble des vérifications à effectuer, consultez aussi les solutions aux mises à jour WordPress qui échouent.

Reconnaître les symptômes d’une mise à jour bloquée

Le message de maintenance reste affiché

Le message « Briefly unavailable for scheduled maintenance » apparaît pendant certaines mises à jour. S’il reste affiché après une interruption, le fichier .maintenance peut être resté à la racine du site.

Attendez d’abord la fin de l’opération : ne supprimez pas ce fichier pendant qu’une mise à jour est encore en cours. Si le site reste bloqué, connectez-vous en FTP ou SFTP, ou utilisez le gestionnaire de fichiers de votre hébergement. Repérez .maintenance à la racine de WordPress, supprimez-le, puis rechargez la page.

Ce geste retire le message, mais ne termine pas nécessairement une mise à jour interrompue. Vérifiez ensuite Tableau de bord > Mises à jour et l’état du site avant de relancer l’opération.

Une erreur 500, 502 ou 503 apparaît

Une erreur 500 indique généralement un problème côté serveur. Elle peut notamment être liée à PHP, à une extension, aux limites de mémoire, aux permissions ou à des règles du fichier .htaccess.

Les erreurs 502 et 503 peuvent, quant à elles, signaler un serveur surchargé ou un processus PHP qui ne répond pas. Consultez les journaux d’erreurs PHP et du serveur web depuis votre hébergement si vous y avez accès. Le nom d’un fichier ou d’une extension dans le journal peut orienter vos recherches.

Vérifiez les ressources disponibles avec votre hébergeur. Si sa configuration le permet, une augmentation temporaire de la mémoire PHP peut aider à confirmer une limite trop basse. Ne modifiez pas plusieurs paramètres simultanément : testez le site après chaque changement.

Le site affiche une page blanche

Un écran blanc peut masquer une erreur fatale PHP. Une extension incompatible, un thème utilisant une fonction devenue problématique ou une configuration PHP inadaptée peuvent en être à l’origine.

Commencez par consulter les journaux d’erreurs. Vous pouvez aussi activer temporairement le mode de débogage de WordPress dans wp-config.php, en évitant d’afficher les erreurs aux visiteurs sur un site en production. Le message enregistré peut indiquer le fichier responsable.

Si le journal ne suffit pas, désactivez les extensions, puis testez un thème par défaut comme indiqué dans la procédure ci-dessous. Les pistes propres à WordPress en écran blanc peuvent compléter ce diagnostic.

L’administration est inaccessible ou très lente

Le site public peut fonctionner alors que le back-office expire, charge très lentement ou que certaines actions de l’éditeur échouent. Le problème peut provenir d’une extension, de ressources serveur limitées, du cache ou de requêtes coûteuses en base de données.

Examinez en particulier les extensions de sécurité, de sauvegarde et de statistiques récemment mises à jour. Consultez les journaux et les ressources de l’hébergement, puis testez les extensions une par une. Une table de base de données volumineuse peut aussi contribuer aux lenteurs, mais ne supprimez pas de données sans sauvegarde ni diagnostic.

Comprendre les causes fréquentes d’un échec de mise à jour

Avant de modifier le site, comparez vos observations avec les causes les plus courantes. Plusieurs peuvent se cumuler.

• Conflit d’extension ou de thème : un composant peut être incompatible avec WordPress, PHP ou une autre extension.
• Ressources serveur insuffisantes : télécharger, décompresser et remplacer des fichiers consomme de la mémoire et du temps de traitement. Une limite ou un délai d’exécution peut interrompre l’opération.
• Permissions ou propriétaire des fichiers : WordPress doit pouvoir écrire dans les dossiers concernés. Des droits ou un propriétaire mal configurés peuvent empêcher le remplacement des fichiers.
• Opération interrompue : une perte de connexion, une tâche arrêtée ou un processus terminé par l’hébergement peut laisser la mise à jour inachevée.
• Cache ou optimisation : une ancienne ressource, une minification ou une combinaison de scripts peut provoquer un affichage incohérent ou perturber l’éditeur.

Ces pistes ne justifient pas de changer tous les réglages. Utilisez-les pour choisir un test, observez le résultat et conservez une trace de vos modifications. Si les permissions semblent en cause, demandez à votre hébergeur de vérifier la configuration plutôt que d’ouvrir largement les droits des fichiers.

Dépanner WordPress après une mise à jour, étape par étape

Sauvegarder les fichiers et la base de données

Depuis le panneau de votre hébergeur, créez une copie de la base de données et des fichiers du site. Si une copie complète des fichiers n’est pas possible, conservez au minimum wp-content, qui contient notamment les extensions, les thèmes et les médias.

Repérez également une sauvegarde antérieure à l’incident et vérifiez qu’elle peut être restaurée. La copie du site en panne et la sauvegarde antérieure ont des usages différents : la première préserve l’état actuel, la seconde peut servir à revenir à une situation précédente.

Vérifier l’état de la mise à jour

Si vous avez accès à l’administration, ouvrez Tableau de bord > Mises à jour. Vérifiez si WordPress, une extension ou un thème indique encore une mise à jour disponible. Notez également les messages affichés.

Si une mise à jour du cœur a été interrompue et que ses fichiers sont partiellement remplacés, une réinstallation manuelle des fichiers WordPress peut être nécessaire. Utilisez les fichiers officiels correspondant à la version à installer, en conservant wp-content et wp-config.php. Cette opération demande de la prudence : sauvegardez d’abord et ne supprimez pas les fichiers propres au site.

Désactiver les extensions, puis les tester

Si le back-office fonctionne, allez dans Extensions > Extensions installées et désactivez les extensions. Testez le site, puis réactivez-les une par une en vérifiant à chaque fois si le problème revient.

Commencez vos recherches par les extensions récemment mises à jour, puis par celles qui interviennent sur le cache, la sécurité, les sauvegardes, les redirections, la traduction, la boutique ou la construction des pages.

Si l’administration est inaccessible, connectez-vous en FTP ou SFTP et renommez temporairement le dossier wp-content/plugins, par exemple en plugins-desactives. WordPress ne pourra plus charger les extensions de ce dossier. Si le site revient, redonnez son nom initial au dossier, puis accédez à l’administration pour réactiver et tester les extensions individuellement.

La désactivation peut modifier temporairement certaines fonctions du site. Sur une boutique ou un site de réservation, vérifiez les conséquences avant de laisser le site ouvert aux visiteurs.

Tester un thème par défaut

Si le problème persiste avec les extensions désactivées, testez un thème WordPress par défaut de la famille Twenty, s’il est installé. Dans l’administration, ouvrez Apparence > Thèmes, puis activez-le temporairement.

Si le site fonctionne avec ce thème, le thème habituel ou son interaction avec un autre composant peut être en cause. Vérifiez ses mises à jour et les erreurs signalées dans les journaux avant de le réactiver. Un changement de thème peut modifier l’apparence et certains réglages visibles : effectuez ce test sur une copie de préproduction lorsque c’est possible.

Contrôler PHP, les ressources et les caches

Depuis l’hébergement, vérifiez la version de PHP et les extensions serveur disponibles. Comparez-les aux prérequis de WordPress, du thème et des extensions concernées. Une version PHP trop ancienne ou une configuration incompatible peut provoquer une erreur après mise à jour.

Contrôlez également la mémoire, l’espace disque et les limites d’exécution. Si le problème dépend du serveur, les journaux et l’assistance de l’hébergeur peuvent aider à identifier la limite atteinte.

Enfin, purgez une fois les caches concernés dans cet ordre : cache de l’extension, cache serveur, cache CDN, puis cache du navigateur. Retestez dans une fenêtre privée. Si l’affichage reste incorrect, cherchez la cause plutôt que de vider les caches en boucle.

Bug connu ou retour arrière : comment rétablir le site

Une mise à jour peut révéler un bug déjà signalé dans une configuration comparable à la vôtre. Recherchez le message d’erreur exact et le nom du composant concerné dans les forums de support officiels, puis comparez les versions, les extensions et l’environnement avant d’appliquer une solution proposée.

Vérifiez aussi si la mise à jour corrige une faille de sécurité. Si vous devez la différer à cause d’une incompatibilité, faites-le de manière contrôlée : conservez des sauvegardes, surveillez le site, testez le correctif sur une copie et planifiez une nouvelle tentative.

Quand envisager une restauration

Revenir à un état antérieur peut servir de solution temporaire si le site reste inutilisable, par exemple après une erreur fatale persistante ou sur une boutique indisponible. Ce retour arrière comporte toutefois des risques : perte de modifications récentes, incompatibilité de base de données ou réapparition d’une faille corrigée.

Avant toute restauration :

1. Sauvegardez l’état actuel des fichiers et de la base.
2. Identifiez une sauvegarde antérieure à la panne et son contenu.
3. Repérez les changements effectués depuis cette sauvegarde, notamment les commandes ou contenus récents.
4. Préparez la restauration adaptée, puis contrôlez le site et ses données.

Ne supposez pas que remplacer uniquement une extension ou le cœur remettra aussi la base de données dans son état précédent. Après le rétablissement, recherchez l’incompatibilité et préparez une mise à jour corrigée. Pour approfondir les contrôles, consultez le guide sur un site WordPress cassé après une mise à jour.

Vérifier le site après la correction

Le retour de la page d’accueil ne suffit pas à confirmer que tout fonctionne. Testez les parcours utilisés par vos visiteurs et les actions courantes dans l’administration.

• Site public : navigation, recherche, formulaires, pages de contact et pages protégées. Vérifiez aussi les langues si le site est multilingue.
• Boutique : fiches produits, panier et parcours de commande, sans oublier les fonctions liées aux extensions désactivées ou mises à jour.
• Administration : modification d’un article, téléversement d’un média, éditeur de blocs ou constructeur de pages, menus et widgets.
• Performances : temps de réponse et éventuels pics de ressources ou requêtes lentes observables chez l’hébergeur.
• Journaux : erreurs PHP répétées, tâches planifiées et problèmes liés à l’API REST.

Réactivez les fonctions mises en pause pendant le dépannage, puis contrôlez-les à nouveau. Si un formulaire ou une commande ne fonctionne plus, notez précisément l’étape concernée et comparez-la aux messages des journaux.

Prévenir les prochains problèmes de mise à jour WordPress

Une méthode de mise à jour régulière réduit les risques et facilite le retour arrière. Elle repose sur des sauvegardes exploitables, des tests et une validation après chaque intervention.

Avant une nouvelle mise à jour, vérifiez les prérequis PHP et la compatibilité des extensions et du thème. Remplacez les extensions abandonnées lorsque cela est possible, et évitez de multiplier les outils de cache ou de minification qui agissent sur les mêmes fichiers.

Procédez ensuite par étapes :

1. Vérifiez qu’une sauvegarde récente des fichiers et de la base peut être restaurée.
2. Testez les mises à jour sur un site de préproduction lorsque vous en disposez.
3. Mettez à jour par petits lots plutôt que le cœur, le thème et toutes les extensions simultanément.
4. Contrôlez les fonctions importantes après chaque lot et consultez les journaux.
5. Prévoyez la marche à suivre si une incompatibilité apparaît.

Organisez également le suivi : qui contrôle les sauvegardes, teste les mises à jour, surveille les erreurs et intervient en cas de panne ? Pour cadrer ce travail, la page consacrée aux mises à jour WordPress présente les éléments concernés, du cœur aux extensions, au thème et à PHP.

Questions fréquentes

Article rédigé avec l’aide d’une IA à partir des sources citées et de notre pratique de la maintenance WordPress. Notre méthode éditoriale.