Pourquoi le site reste bloqué
Pendant chaque mise à jour, WordPress crée un fichier nommé .maintenance à la racine du site.
Tant qu'il existe, chaque visiteur voit le message
« Brièvement indisponible pour cause de maintenance planifiée. Veuillez revenir dans une minute. »
(« Briefly unavailable for scheduled maintenance » sur un site en anglais). À la fin de la mise à
jour, WordPress supprime le fichier.
Si la mise à jour est interrompue — délai d'exécution dépassé, mémoire PHP saturée, onglet fermé, plusieurs extensions mises à jour en même temps — le fichier reste en place, et le site avec lui.
Le détail que peu de guides mentionnent
Le fichier créé par WordPress contient l'heure de début de la mise à jour, et WordPress l'ignore automatiquement au bout de 10 minutes. Si votre site est bloqué depuis plus longtemps, ce n'est donc probablement pas ce fichier seul : soit il a été créé par un autre outil (WP-CLI, une extension de maintenance), soit un cache continue de servir l'ancienne page. Les étapes 1 et 5 couvrent les deux cas.
1. Supprimer le fichier .maintenance
Connectez-vous en SFTP (FileZilla, par exemple) ou ouvrez le gestionnaire de fichiers de votre hébergeur.
Allez dans le dossier racine du site — celui qui contient wp-config.php,
wp-admin et wp-content.
Le nom commence par un point : c'est un fichier caché. Dans FileZilla, activez
Serveur → Forcer l'affichage des fichiers cachés ; dans cPanel, cochez
« Afficher les fichiers cachés » dans les réglages du gestionnaire. Supprimez .maintenance,
puis rechargez le site.
Avec WP-CLI, une seule commande suffit :
wp maintenance-mode deactivate2. Nettoyer le dossier de mise à jour
Ouvrez wp-content/upgrade/. S'il contient des dossiers, ce sont les restes de la mise à jour
interrompue. Supprimez son contenu (pas le dossier lui-même). Sinon, la prochaine tentative peut
échouer avec « Impossible de créer le répertoire » ou « Le dossier de destination existe déjà ».
3. Vérifier ce que la mise à jour a laissé à moitié fait
C'est l'étape que l'on saute, et c'est elle qui provoque la panne suivante. Une extension interrompue en pleine copie de fichiers peut contenir un mélange d'ancienne et de nouvelle version.
- Le site revient normalement ? Allez dans Tableau de bord → Mises à jour. Si l'élément y figure encore, relancez sa mise à jour — une seule à la fois.
- Le site affiche une erreur critique ou une page blanche ? L'extension est incomplète.
Renommez son dossier dans
wp-content/plugins/pour la désactiver, puis réinstallez-la proprement. Voir le guide de l'erreur critique. - C'était une mise à jour du cœur WordPress ? Relancez-la depuis Tableau de bord → Mises à jour → Réinstaller. Vos contenus et réglages ne sont pas touchés.
4. Comprendre pourquoi elle a été interrompue
| Situation | Cause probable | Prévention |
|---|---|---|
| Vous avez cliqué « Tout mettre à jour » | Trop d'extensions à la suite, délai PHP dépassé | Mettre à jour par petits groupes |
| Grosse extension (constructeur de pages, WooCommerce) | Archive volumineuse, max_execution_time trop court | Augmenter la limite chez l'hébergeur |
| « Allowed memory size exhausted » dans le journal | Mémoire PHP insuffisante | Augmenter WP_MEMORY_LIMIT |
| Bloqué pendant une mise à jour automatique nocturne | Cron WordPress interrompu | Surveiller le site, ou passer en mises à jour testées |
5. Vider tous les caches
Si le fichier n'existe plus mais que le message s'affiche encore, la page de maintenance est servie depuis un cache. Purgez dans l'ordre : l'extension de cache (WP Rocket, LiteSpeed Cache, W3 Total Cache…), le cache de l'hébergeur (Varnish, cache serveur), puis le CDN (Cloudflare). Testez ensuite en navigation privée.
Le site reste en maintenance ?
Envoyez-moi l'adresse du site. Un mode maintenance bloqué se débloque généralement en un quart d'heure — et je vérifie que la mise à jour interrompue n'a rien cassé d'autre.
Questions fréquentes
Combien de temps dure normalement le mode maintenance ?
Quelques secondes par élément mis à jour. WordPress ignore de lui-même le fichier .maintenance qu'il a créé au bout de 10 minutes : au-delà, cherchez un cache ou un fichier créé par un autre outil.
Je ne vois pas le fichier .maintenance. Pourquoi ?
Son nom commence par un point, c'est donc un fichier caché. Activez l'affichage des fichiers cachés dans votre client SFTP ou dans le gestionnaire de fichiers de l'hébergeur.
Supprimer .maintenance peut-il casser mon site ?
Non. Le fichier ne contient qu'une indication d'heure. Le risque vient de la mise à jour interrompue elle-même : vérifiez ensuite l'extension ou le thème concerné.
Comment éviter que cela se reproduise ?
Mettez à jour une extension à la fois, en particulier les plus volumineuses, gardez une sauvegarde récente, et évitez de fermer l'onglet pendant une mise à jour.