WordPress bloqué en mode maintenance : comment débloquer votre site 🚧

Vous avez lancé une mise à jour ou simplement ouvert votre site un matin, et il n’affiche plus qu’une phrase sur fond blanc : « Indisponibilité temporaire pour cause de maintenance. Veuillez revenir dans un instant. » Selon la version et la langue de votre installation, la formulation peut varier, par exemple « Brièvement indisponible pour cause de maintenance planifiée. Revenez dans une minute. » ou, en anglais, « Briefly unavailable for scheduled maintenance. Check back in a minute. » Les minutes passent, rien ne bouge, et vos visiteurs voient la même chose que vous. Bonne nouvelle, c’est l’une des pannes les plus simples à corriger, et si vous préférez déléguer, notre équipe se charge de corriger les erreurs et blocages de WordPress.

D’où vient le blocage en mode maintenance ?

À chaque mise à jour de WordPress, d’une extension ou d’un thème, WordPress crée à la racine du site un fichier nommé .maintenance. La racine, c’est le dossier principal du site, celui qui contient wp-config.php et les dossiers wp-admin, wp-content et wp-includes. Tant que ce fichier est présent, les visiteurs reçoivent le message de maintenance avec un code 503, « service indisponible », que nous présentons dans notre article pour comprendre les erreurs HTTP de WordPress. Le fichier ne contient que l’heure de début de la mise à jour, et WordPress le supprime dès que l’opération se termine.

Le blocage survient quand la mise à jour s’arrête en route. Les causes, de la plus courante à la plus rare :

• Une mise à jour interrompue : page fermée ou rechargée pendant l’opération, ordinateur mis en veille, connexion coupée.
• Trop de mises à jour lancées en même temps, qui allongent l’opération et augmentent le risque qu’elle n’aille pas au bout.
• Une limite du serveur atteinte, en temps d’exécution ou en mémoire, qui coupe la mise à jour sans prévenir.
• Une erreur grave pendant l’installation de la nouvelle version, qui arrête net le processus.
• Plus rarement, une mise à jour automatique ou lancée depuis un outil de gestion à distance qui s’est mal terminée.

Bon à savoir : le code de WordPress considère la maintenance comme terminée au bout de dix minutes, même si le fichier est toujours là. Attendre suffit donc parfois, mais la mise à jour interrompue a pu laisser une extension ou un thème à moitié installé, qu’il faudra vérifier.

Comment débloquer WordPress du mode maintenance étape par étape

1. Patientez quelques minutes, puis rechargez la page

Si la mise à jour vient d’être lancée, elle est peut-être encore en cours. Laissez-lui quelques minutes, sans relancer l’opération ni fermer l’onglet de l’administration, puis rechargez votre site. S’il réapparaît, passez directement à l’étape 5 pour vérifier que les mises à jour sont bien allées au bout.

2. Sauvegardez avant d’intervenir

Supprimer le fichier de maintenance ne présente presque aucun risque, mais la suite peut vous amener à toucher aux extensions. Sauvegardez donc les fichiers et la base de données, la partie qui contient vos textes et vos réglages, depuis l’espace client de votre hébergeur, puisque l’administration affiche elle aussi le message. Notre guide pour sauvegarder son site WordPress détaille les options possibles.

3. Accédez aux fichiers et affichez les fichiers cachés

Connectez-vous aux fichiers du site par FTP, c’est-à-dire l’accès aux fichiers du site, comme un explorateur de fichiers à distance, avec un logiciel comme FileZilla. Le gestionnaire de fichiers de votre hébergeur fait aussi l’affaire. Ouvrez ensuite la racine du site. Son nom commençant par un point, beaucoup de logiciels le considèrent comme caché : activez l’affichage des fichiers cachés dans leurs réglages.

4. Supprimez le fichier .maintenance

Repérez le fichier .maintenance, au même niveau que wp-config.php, et supprimez-le, comme le recommande la documentation officielle de WordPress en français. Rechargez votre site : le message doit disparaître aussitôt. S’il s’affiche encore, videz le cache de votre navigateur, puis celui de votre extension de cache ou de votre hébergeur.

5. Vérifiez les extensions et le thème à moitié mis à jour

C’est l’étape que l’on oublie. Connectez-vous à l’administration et ouvrez Tableau de bord, puis Mises à jour : les extensions, thèmes ou traductions qui y figurent encore n’ont pas été mis à jour. Dans le menu Extensions, vérifiez ensuite que toutes vos extensions sont présentes et actives : une extension interrompue en pleine mise à jour peut avoir disparu ou avoir été désactivée.

Depuis WordPress 6.3, quand la mise à jour manuelle d’une extension ou d’un thème échoue, WordPress tente de remettre l’ancienne version en place, mais ce filet de sécurité ne peut pas tout rattraper si le processus est coupé net. Si une extension manque, réinstallez-la depuis Extensions, puis Ajouter une extension, ou à partir du fichier fourni par son éditeur s’il s’agit d’une extension payante. Ses réglages, enregistrés dans la base de données, sont en principe conservés. Si c’est WordPress lui-même qui était en cours de mise à jour, la page Mises à jour propose de réinstaller la version actuelle. Et si le site affiche « Il y a eu une erreur critique sur ce site. », notre guide sur l’erreur critique WordPress prend le relais.

6. Relancez les mises à jour restantes une par une

Reprenez les mises à jour qui n’ont pas abouti, une à la fois, en vérifiant le site après chacune. C’est plus long, mais si l’une d’elles pose problème, vous saurez immédiatement laquelle. Gardez l’onglet ouvert jusqu’au message de fin et évitez de lancer l’opération depuis une connexion instable.

Quand faire appel à un professionnel ?

Supprimer un fichier est à la portée de tous, mais certaines situations méritent l’aide d’un professionnel :

• une extension a disparu et vous craignez d’avoir perdu ses données ou ses réglages ;
• la mise à jour interrompue concernait WordPress lui-même ou WooCommerce, et votre boutique ne prend plus de commandes ;
• vous constatez des fichiers inconnus ou des comportements inhabituels qui font penser à un piratage ;
• le fichier .maintenance est introuvable, ou le message revient après sa suppression ;
• vous n’avez ni accès FTP ni accès à l’espace client de votre hébergeur ;
• le site affiche une erreur critique ou une page blanche une fois débloqué.