« Indisponibilité temporaire pour cause de maintenance » : débloquer votre site

Si votre site WordPress affiche « Indisponibilité temporaire pour cause de maintenance. Veuillez revenir dans un instant. », supprimez le fichier .maintenance à la racine de l’installation : le site revient immédiatement. Ce fichier est créé par WordPress au début d’une mise à jour et effacé à la fin. Si la mise à jour s’est interrompue, il reste en place et bloque tout le site.

D’où vient exactement ce message

Avant de mettre à jour le cœur, une extension ou un thème, WordPress écrit un fichier à la racine de l’installation. Son contenu tient en une ligne : un horodatage Unix marquant le début de l’opération.

<?php $upgrading = 1755689400; ?>

Tant que ce fichier existe, chaque visite est interceptée très tôt dans le chargement de WordPress. La fonction wp_maintenance() envoie un en-tête Retry-After: 600, puis interrompt la requête avec un statut HTTP 503 et ce message. C’est un comportement voulu : pendant qu’un fichier du cœur est remplacé, un visiteur ne doit pas charger une installation à moitié mise à jour.

Le problème n’est donc pas le message, mais le fait qu’il dure. Une mise à jour normale prend quelques secondes, et WordPress efface le fichier en sortant.

La règle des dix minutes

Point que la plupart des articles omettent : WordPress ne se fie pas seulement à la présence du fichier, il regarde aussi son horodatage. Si celui-ci a plus de dix minutes, la maintenance est considérée comme terminée et le site répond de nouveau normalement, même si .maintenance est toujours là.

Cette règle donne un repère de diagnostic utile : si le message s’affiche encore plus de dix minutes après l’incident, le fichier oublié n’est pas la seule explication. Supprimez-le d’abord ; s’il revient, la section suivante liste les causes par ordre de fréquence.

Supprimer le fichier, trois chemins possibles

Par le gestionnaire de fichiers de l’hébergeur

C’est la voie la plus courte, et la seule disponible sans client FTP ni accès SSH. Ouvrez le gestionnaire de fichiers, entrez dans le dossier du site, puis activez l’affichage des fichiers cachés : un nom commençant par un point est masqué par défaut, et beaucoup de gens en concluent à tort que le fichier n’existe pas.

Par FTP ou SFTP

Dans FileZilla, Cyberduck ou l’outil de votre choix, ouvrez le répertoire qui contient wp-config.php, wp-admin et wp-content. Pensez là aussi à afficher les fichiers cachés. Le fichier .maintenance pèse quelques dizaines d’octets.

En ligne de commande

Si vous disposez d’un accès SSH, l’opération est immédiate :

cd /chemin/vers/le/site
ls -la .maintenance
rm .maintenance

Ne supprimez rien d’autre. En particulier, ne touchez ni à wp-config.php ni au dossier wp-content : plusieurs procédures trouvées en ligne mélangent ce dépannage avec la réparation d’une installation cassée, qui est un autre problème.

Le message persiste ou revient : cinq causes

1. Une page mise en cache

C’est de loin la cause la plus fréquente d’un message qui survit à la suppression du fichier. Une extension de cache, un cache serveur ou un CDN a enregistré la réponse 503 et continue de la servir. Videz les caches dans cet ordre : extension, hébergeur, puis CDN. Testez ensuite en navigation privée, ou avec la commande donnée plus bas, plutôt que dans l’onglet qui affichait déjà l’erreur.

2. Une horloge serveur incohérente

La règle des dix minutes compare l’horodatage du fichier à l’heure courante. Si cet horodatage se situe dans le futur — décalage d’horloge, restauration d’une sauvegarde, migration entre deux serveurs —, la soustraction ne dépasse jamais dix minutes et le message ne s’arrête jamais de lui-même. La suppression manuelle reste alors la seule issue.

3. La mise à jour a réellement échoué

Si le site affiche une page blanche ou une erreur critique après la suppression du fichier, l’interruption a laissé des fichiers incomplets. Réinstallez la version du cœur depuis Tableau de bord → Mises à jour, ou remplacez les dossiers wp-admin et wp-includes par ceux d’une archive officielle de la même version. Le contenu et la base de données ne sont pas concernés.

4. Un fichier maintenance.php dans wp-content

WordPress prévoit une page de maintenance personnalisée sous forme de drop-in : si wp-content/maintenance.php existe, il remplace le message par défaut. Certaines extensions et certains hébergeurs en déposent un. S’il est resté, il continue de s’afficher.

5. Une extension de maintenance restée active

Si le message affiché n’est pas exactement celui de WordPress, il ne vient pas du fichier .maintenance mais d’une extension. Désactivez-la depuis l’administration, qui reste accessible dans la plupart des cas.

Vérifier que le site est vraiment revenu

Regarder la page ne suffit pas : le code HTTP se lit, il ne se voit pas. Un site qui affiche son contenu tout en répondant 503 continue d’envoyer aux moteurs le signal d’une panne. Le contrôle tient en une commande :

curl -I https://votre-site.fr/

La première ligne doit indiquer HTTP/2 200. Si vous lisez encore 503, la cause figure dans la liste ci-dessus — presque toujours un cache. Vérifiez aussi que /robots.txt répond 200 : un statut d’erreur prolongé sur ce seul fichier fait cesser l’exploration du site entier.

Éviter que cela recommence

• Mettez à jour une chose à la fois. Les mises à jour groupées allongent la fenêtre pendant laquelle une coupure peut survenir.
• Sauvegardez avant, et sachez comment restaurer : une sauvegarde dont on ignore la procédure de restauration ne sert à rien.
• Évitez de fermer l’onglet pendant une mise à jour du cœur.
• Pour une intervention volontaire de plus de quelques minutes, ne comptez pas sur ce mécanisme : il n’est pas prévu pour cela.

Une maintenance subie, une maintenance choisie

Le fichier .maintenance est un verrou technique de quelques secondes, pas un mode maintenance. Il n’affiche pas votre marque, ne prévoit pas d’accès administrateur et s’efface de lui-même au bout de dix minutes : exactement ce qu’il ne faut pas pendant une refonte.

Pour une intervention planifiée, la logique s’inverse. Vous voulez une page présentable, un accès à l’administration préservé, un statut 503 explicite envoyé aux moteurs, et la maîtrise du moment de la réouverture. C’est ce que fait Mes503 Maintenance Page, en bêta gratuite 0.1.5. La méthode complète est détaillée ici.