Mises à jour WordPress qui échouent : comment les réparer

Si vos mises à jour WordPress échouent, commencez par relever le message d’erreur et vérifier que vous disposez d’une sauvegarde complète. Un conflit avec une extension ou un thème, des fichiers endommagés ou une configuration serveur peuvent être en cause. Les vérifications ci-dessous vous aideront à identifier le problème avant de relancer la mise à jour.

Sauvegarder le site et relever l’erreur

Avant toute intervention, sauvegardez les fichiers et la base de données du site. Vérifiez que vous pouvez accéder à cette sauvegarde et la restaurer si nécessaire. C’est particulièrement important avant de remplacer des fichiers, de changer de thème ou de réparer la base de données.

Notez ensuite le message affiché lors de l’échec : il peut indiquer si le problème concerne le téléchargement, les fichiers ou le serveur. Consultez également le journal d’erreurs du serveur ou de WordPress. Si vous ne savez pas où le trouver, reportez-vous à la documentation de votre hébergeur.

Relevez le moment de l’échec et l’élément que vous tentiez de mettre à jour : cœur de WordPress, extension ou thème. Ces informations permettent de rechercher plus facilement une erreur correspondante dans les journaux et d’éviter de modifier le site au hasard.

Vérifier les accès et la configuration du serveur

Avant de modifier les extensions ou les fichiers, effectuez ces contrôles simples :

• Vérifiez votre connexion Internet, puis reconnectez-vous à l’administration WordPress si votre session a expiré.
• Assurez-vous que votre compte dispose des droits nécessaires pour effectuer les mises à jour.
• Consultez l’espace disponible sur l’hébergement : un espace disque insuffisant peut empêcher le téléchargement ou l’installation.
• Vérifiez auprès de l’hébergeur que le serveur utilise des versions de PHP et de MySQL compatibles avec votre site et les éléments à mettre à jour.
• Contrôlez les permissions et le propriétaire des fichiers si WordPress indique qu’il ne peut pas écrire dans ses dossiers.

Ne modifiez pas les permissions au hasard pour contourner une erreur. Si leur configuration vous semble incorrecte, demandez à votre hébergeur quelles valeurs et quel propriétaire sont adaptés à son environnement.

Vous pouvez aussi consulter ces autres pistes en cas de problème de mise à jour WordPress.

Tester les extensions et le thème

Une extension ou un thème incompatible peut perturber une mise à jour. Testez cette piste après avoir sauvegardé le site, de préférence sur une copie de test : la désactivation d’une extension ou le changement de thème peut modifier l’apparence et les fonctionnalités du site.

Désactiver les extensions temporairement

1. Dans l’administration, ouvrez Extensions > Extensions installées.
2. Désactivez les extensions que vous soupçonnez, ou toutes les extensions si vous ne savez pas laquelle tester.
3. Réessayez la mise à jour qui a échoué.
4. Si elle fonctionne, réactivez les extensions une par une et vérifiez le site après chaque réactivation afin d’identifier un éventuel conflit.

Notez les extensions désactivées pour pouvoir rétablir leur état initial. Certaines fonctions, comme un formulaire ou une boutique, peuvent être indisponibles pendant le test.

Vérifier le thème actif

WordPress utilise un seul thème actif à la fois : on ne le désactive pas sans en activer un autre. Dans Apparence > Thèmes, activez temporairement un thème WordPress par défaut déjà installé, puis réessayez la mise à jour. Si le problème disparaît, vérifiez la compatibilité du thème initial et remettez-le en place après le test.

Contrôler les fichiers et relancer la mise à jour

Des fichiers incomplets ou corrompus peuvent provoquer un échec. WordPress ne propose pas de rubrique native « Outils > Vérification des fichiers » : ne cherchez donc pas ce menu pour effectuer le contrôle.

Pour les fichiers du cœur de WordPress, vous pouvez tenter une réinstallation depuis Tableau de bord > Mises à jour, si l’option est proposée. Cette opération remplace les fichiers du cœur, mais ne remplace pas une sauvegarde préalable. Vérifiez ensuite que le site et son administration fonctionnent.

Si la mise à jour depuis l’administration reste impossible, une mise à jour manuelle par FTP est envisageable :

1. Téléchargez l’archive WordPress depuis la source officielle et décompressez-la sur votre ordinateur.
2. Connectez-vous à votre hébergement par FTP avec les accès fournis par votre hébergeur.
3. Transférez les fichiers du cœur nécessaires en suivant les instructions officielles, sans écraser votre fichier wp-config.php ni le dossier wp-content.
4. Connectez-vous à l’administration et suivez les éventuelles instructions de mise à jour de la base de données.
5. Vérifiez les pages principales, les extensions et les fonctions importantes du site.

Un client FTP comme FileZilla peut servir au transfert : le point important est de manipuler les bons fichiers et de conserver une sauvegarde. Pour une intervention sur l’ensemble des composants, consultez notre page sur les mises à jour WordPress.

Examiner la base de données et contacter l’hébergeur

Une base de données endommagée peut aussi être à l’origine d’erreurs. Ne lancez pas de réparation ou de requête SQL sans indice et sans sauvegarde : commencez par rechercher les messages qui signalent un problème de base de données.

Si ces messages apparaissent, suivez les étapes de réparation d’une base de données WordPress corrompue. Après l’intervention, vérifiez que le site fonctionne avant de réessayer la mise à jour.

Si l’échec persiste, transmettez à votre hébergeur le message exact, l’heure de l’incident et les vérifications déjà réalisées. Il pourra examiner les journaux, l’espace disque, les permissions et la configuration du serveur. Si le site est inaccessible ou si vous ne souhaitez pas intervenir vous-même, un dépannage de site WordPress permet de faire examiner le problème.

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.