WordPress bloqué sur « Brièvement indisponible pour cause de maintenance planifiée »

Mis à jour le Durée : 15 minutes

Réponse courte

Le message « Brièvement indisponible pour cause de maintenance planifiée » reste affiché quand une mise à jour s’est interrompue avant de supprimer le fichier .maintenance, créé à la racine du site pendant l’opération. Supprimez ce fichier par FTP ou depuis le gestionnaire de fichiers de l’hébergeur, puis vérifiez que la mise à jour s’est bien terminée.

WordPress place le site en maintenance pendant qu’il met à jour le noyau, un thème ou une extension. Il écrit pour cela un fichier .maintenance à la racine et le supprime à la fin. Si le processus s’arrête en route (fenêtre fermée, délai d’exécution dépassé, mémoire insuffisante, coupure de connexion), le fichier reste et tous les visiteurs voient le message, administrateurs compris.

Le cas est sans gravité tant qu’on agit dans l’ordre : retirer le fichier rend le site, puis il faut contrôler ce qui a été laissé à moitié installé. Un visiteur ne peut rien faire d’autre que patienter ; les étapes ci-dessous s’adressent au propriétaire du site.

Confirmer que la mise à jour n’est pas encore en cours

Une mise à jour peut durer plusieurs minutes quand le site est volumineux ou l’hébergement lent. Si le message est apparu il y a peu, laissez la page se recharger puis revenez. Si le message persiste après un moment raisonnable, ou si vous savez que la fenêtre de mise à jour a été fermée, passez à la suppression du fichier. Aucun risque à le faire : la mise à jour en cours, si elle existe, aurait déjà dû se terminer.

Se connecter aux fichiers du site

Utilisez un client FTP ou SFTP avec les identifiants de l’hébergeur, ou le gestionnaire de fichiers de son espace client. Placez-vous dans le dossier qui contient wp-config.php et les dossiers wp-admin et wp-content. C’est la racine de WordPress, parfois nommée public_html, www ou htdocs.

Afficher les fichiers cachés

Le nom .maintenance commence par un point : la plupart des clients FTP et des gestionnaires de fichiers le masquent par défaut. Activez l’option d’affichage des fichiers cachés, souvent libellée « Afficher les fichiers cachés » ou « Show hidden files ». Dans FileZilla, elle se trouve dans le menu Serveur, sous « Forcer l’affichage des fichiers cachés ». Sans cette option, le fichier est invisible et on conclut à tort qu’il n’existe pas.

Supprimer le fichier .maintenance

Repérez .maintenance à la racine, à côté de wp-config.php, et supprimez-le. Aucun autre fichier n’est à toucher. Rechargez le site avec Ctrl + F5 pour éviter le cache du navigateur. Le site doit s’afficher de nouveau normalement. Si le message persiste, videz le cache de pages (extension de cache, cache de l’hébergeur ou CDN), qui peut conserver la page de maintenance.

Identifier ce qui n’a pas été mis à jour

Connectez-vous à l’administration et ouvrez Tableau de bord, puis Mises à jour. WordPress liste le noyau, les extensions et les thèmes dont la version est restée en retard. Notez ce qui s’affiche. Une extension mise à jour à moitié peut provoquer des erreurs : si le tableau de bord signale un problème avec une extension précise, réinstallez-la depuis la page Extensions ou en déposant une copie propre, téléchargée sur wordpress.org, dans wp-content/plugins.

Relancer la mise à jour interrompue

Relancez une seule mise à jour à la fois, en commençant par celle qui était en cours. Faites une sauvegarde des fichiers et de la base avant de recommencer. Si l’opération échoue à nouveau, augmentez la limite de mémoire en suivant le guide sur la mémoire épuisée, puis réessayez. Pour une mise à jour du noyau qui ne passe pas en automatique, la mise à jour manuelle décrite par WordPress.org reste possible.

Vérifier le site après la reprise

Parcourez les pages principales, le formulaire de contact, la connexion à l’administration et, pour une boutique, le panier. Si une page affiche une page blanche ou une erreur, le guide sur l’écran blanc WordPress donne la marche à suivre. Activez les mises à jour de sécurité automatiques seulement après avoir confirmé que les sauvegardes sont fiables.

Questions fréquentes

Combien de temps dure le mode maintenance de WordPress ?

Il ne devrait durer que le temps de la mise à jour, de quelques secondes à quelques minutes selon la taille du site. S’il reste affiché bien au-delà, c’est que l’opération a été interrompue et que le fichier .maintenance n’a pas été supprimé : retirez-le à la racine du site.

Je ne vois pas le fichier .maintenance dans mon FTP, que faire ?

Le fichier est caché parce que son nom commence par un point. Activez l’affichage des fichiers cachés dans votre client FTP ou dans le gestionnaire de fichiers de l’hébergeur, puis actualisez la liste. Vérifiez aussi que vous êtes dans le dossier qui contient wp-config.php, pas dans un sous-dossier.

Le site reste en maintenance même après avoir supprimé le fichier, pourquoi ?

Une page de cache sert encore l’ancienne version. Videz le cache de l’extension, celui de l’hébergeur et celui du CDN s’il y en a un, puis testez en navigation privée. Vérifiez aussi qu’une extension de maintenance n’affiche pas son propre écran, distinct du message natif de WordPress.

Peut-on perdre des données à cause d’une mise à jour interrompue ?

Les contenus (articles, pages, commandes) sont dans la base et ne sont normalement pas touchés par une mise à jour de fichiers. Le risque porte sur les fichiers de l’extension ou du noyau, à moitié copiés. D’où l’intérêt d’une sauvegarde avant de relancer l’opération.

Comment éviter que le blocage se reproduise ?

Évitez de lancer plusieurs mises à jour en même temps et ne fermez pas la page pendant l’opération. Augmentez la mémoire si l’erreur était liée à elle, mettez à jour par petits lots, et gardez une sauvegarde récente. Si votre hébergement est lent, privilégiez les heures de faible trafic.

Sources

Voir aussi

Nos garanties

Comment se passe l’intervention