Comprendre le problème
Un échec de mise à jour de WordPress survient quand le processus de remplacement des fichiers du cœur s'interrompt : timeout, permissions de fichiers insuffisantes, accès FTP manquant ou espace disque saturé. Le site reste alors en mode maintenance ou affiche une erreur, mais la mise à jour manuelle reste possible.
La piste à vérifier
Supprimez le fichier .maintenance par FTP, puis relancez la mise à jour depuis le tableau de bord ; si elle échoue encore, mettez WordPress à jour manuellement en remplaçant les dossiers wp-admin et wp-includes.
Comment reconnaître ce bug
- La mise à jour s'arrête en cours et le site reste en mode maintenance
- Le tableau de bord propose à nouveau la même mise à jour
- Une erreur apparaît : « La mise à jour a échoué » ou « impossible de copier les fichiers »
- Le site affiche une erreur critique après une tentative de mise à jour
Qu’est-ce que ce bug ?
Mettre à jour le cœur de WordPress consiste à télécharger la nouvelle version, écraser les anciens fichiers et migrer la base de données. Si l'une de ces étapes échoue — coupure, droits insuffisants, serveur lent — la mise à jour reste incomplète. Le site peut alors mélanger d'anciens et de nouveaux fichiers, source d'erreurs.
Pourquoi ce problème apparaît
Timeout du serveur
Le téléchargement ou la copie des fichiers dépasse le temps d'exécution autorisé.
Permissions de fichiers incorrectes
WordPress n'a pas les droits d'écriture sur wp-admin et wp-includes.
Identifiants FTP manquants
Sur certains hébergeurs, WordPress réclame un accès FTP qu'il ne reçoit pas.
Espace disque saturé
Il ne reste plus assez d'espace pour télécharger et décompresser l'archive de mise à jour.
Comment réparer ce bug
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
Lever le mode maintenance
Par FTP, supprimez le fichier .maintenance à la racine du site pour rétablir l'accès.
Relancer depuis le tableau de bord
Allez dans Tableau de bord > Mises à jour et relancez la mise à jour de WordPress.
Vérifier permissions et espace disque
Réglez les dossiers sur 755 et les fichiers sur 644, et assurez-vous qu'il reste de l'espace disque libre.
Mettre à jour manuellement
Téléchargez WordPress depuis fr.wordpress.org et remplacez par FTP les dossiers wp-admin et wp-includes, sans toucher à wp-content ni wp-config.php.
Finaliser la base de données
Rechargez /wp-admin/ : si WordPress propose une mise à jour de la base de données, validez-la.
Comment éviter qu’il revienne
- Sauvegardez fichiers et base de données avant chaque mise à jour du cœur
- Maintenez des permissions de fichiers correctes (755 / 644)
- Gardez une marge d'espace disque suffisante sur l'hébergement
- Testez les mises à jour majeures sur un site de préproduction
Questions fréquentes
Comment mettre à jour WordPress manuellement après un échec ?
Téléchargez l'archive officielle sur fr.wordpress.org, décompressez-la, puis remplacez par FTP les dossiers wp-admin et wp-includes. Ne touchez pas à wp-content ni à wp-config.php. Rechargez ensuite /wp-admin/.
Une mise à jour échouée a-t-elle cassé mon site ?
Pas nécessairement. Le site peut simplement rester en mode maintenance, ce qui se règle en supprimant le fichier .maintenance. Une mise à jour manuelle propre rétablit ensuite des fichiers cohérents.
Pourquoi WordPress demande un accès FTP pour se mettre à jour ?
Quand les fichiers n'appartiennent pas à l'utilisateur du serveur web, WordPress passe par FTP pour les modifier. Renseigner les bons identifiants FTP, ou corriger la propriété des fichiers, débloque la situation.
Vais-je perdre du contenu en mettant à jour le cœur ?
Non. La mise à jour du cœur ne remplace que wp-admin et wp-includes. Vos thèmes, plugins, médias et la base de données ne sont pas affectés. Une sauvegarde reste toutefois recommandée.