503

Niveau débutant

Site bloqué sur « Bientôt de retour » : le fichier que WordPress a oublié d'effacer

Votre site répète « Briefly unavailable for scheduled maintenance » ? Le fichier .maintenance est resté après une mise à jour. Diagnostic et correctif.

Votre site affiche en boucle « Briefly unavailable for scheduled maintenance. Check back in a minute. » La minute dure depuis ce matin. Bonne nouvelle : la réparation prend quelques secondes, et vous pouvez très probablement la faire vous-même.

Ce qui s'est passé exactement

Avant chaque mise à jour, WordPress dépose un fichier nommé .maintenance à la racine du site. Tant que ce fichier existe, WordPress répond à tout le monde par ce message et un code 503, le temps que l'opération se termine. Puis il le supprime, et le site revient.

Si la mise à jour est interrompue en cours de route, le fichier n'est jamais supprimé. Les trois causes habituelles : le temps d'exécution PHP a expiré, l'onglet du navigateur a été fermé trop tôt, ou la connexion a lâché pendant le téléchargement.

Le détail qui prouve que le site n'est pas cassé

En montant cette panne en laboratoire, j'ai relevé le journal d'erreurs du serveur pendant que le message s'affichait. Il est entièrement vide.

C'est une information, pas une absence d'information. Un site réellement en panne écrit toujours quelque chose dans le journal du serveur. Ici, rien : WordPress fonctionne parfaitement, il a simplement trouvé un fichier qui lui dit de ne servir personne. Vos données sont intactes, votre base n'a rien perdu.

Vérifier en trente secondes

1. Connectez-vous en FTP, ou ouvrez le gestionnaire de fichiers de votre hébergeur.
2. Placez-vous à la racine du site, là où se trouvent wp-config.php et wp-content.
3. Activez l'affichage des fichiers cachés. C'est l'étape que tout le monde saute : un nom qui commence par un point est invisible par défaut, et beaucoup de gens concluent que le fichier n'existe pas alors qu'il est sous leurs yeux.
4. Si .maintenance est là, vous avez trouvé.

Le correctif

Supprimez le fichier. Rechargez le site : il revient immédiatement, sans vider de cache ni redémarrer quoi que ce soit.

Ne vous arrêtez pas là. Le site est revenu, mais la mise à jour qui a échoué, elle, est restée à moitié faite. Une base de données partiellement migrée ne se voit pas tout de suite : elle produit des erreurs bizarres deux semaines plus tard, quand plus personne ne fait le lien. Retournez dans Tableau de bord puis Mises à jour, et relancez proprement celle qui a échoué.

Si le message revient

Un .maintenance qui réapparaît à chaque tentative de mise à jour signale autre chose : un temps d'exécution PHP trop court pour votre hébergement, des droits d'écriture incorrects sur les dossiers, ou une extension qui bloque le processus. Là, supprimer le fichier ne suffira plus, il faut traiter la cause.

C'est mon quotidien. Diagnostic gratuit, et je vous dis franchement si c'est une chose que vous pouvez régler seul.

Pour aller plus loin

• Si le site affiche « Il y a eu une erreur critique sur ce site » au lieu du message de maintenance, c'est une autre panne : voir Page blanche WordPress.
• Si vous obtenez une erreur 500 après la mise à jour : voir Erreur 500 WordPress.