WordPress bloqué en mode maintenance: corriger .maintenance et restaurer l’accès au site

Contexte

Après une mise à jour (WordPress, thème ou plugin), un site est resté bloqué sur le message: « Briefly unavailable for scheduled maintenance. Check back in a minute. ». Le problème survient souvent quand une mise à jour est interrompue (timeout, perte de connexion, conflit) et que le fichier .maintenance reste en place. L’objectif était de rétablir le site rapidement, puis de sécuriser la procédure de mise à jour.

Symptômes observés

• Message de maintenance affiché sur tout le site (front-end et parfois admin).
• Impossible de terminer la mise à jour via /wp-admin.
• Cache et CDN pouvant conserver l’affichage, même après correction.

Objectifs du dépannage

• Retirer le blocage (fichier .maintenance).
• Vérifier que la mise à jour est bien terminée et cohérente.
• Contrôler les permissions fichiers et la stabilité du serveur.
• Éviter la récidive avec une procédure simple (et staging si possible).

Diagnostic

• Accès FTP/SSH pour vérifier la présence de /.maintenance à la racine WordPress.
• Contrôle des permissions (écriture sur wp-content et wp-content/upgrade).
• Vérification de l’espace disque et des limites PHP (timeout, mémoire).
• Contrôle du cache (plugin + Cloudflare) pour éviter un faux positif.

Correctif principal : suppression du fichier .maintenance

Le fichier se trouve à la racine du site WordPress. Une fois supprimé, le site redevient accessible.

/public_html/.maintenance
ou
/web/.maintenance
ou
/httpdocs/.maintenance

Exemple technique : suppression via SSH

Utile quand FTP est lent ou instable.

cd /chemin/vers/la-racine-wordpress
ls -la | grep maintenance
rm -f .maintenance

Exemple technique : contrôle des mises à jour via WP-CLI

Permet de terminer proprement ce qui a été interrompu.

wp core version
wp plugin status
wp plugin update --all
wp theme update --all

Exemple technique : vérifier et nettoyer le dossier upgrade

En cas d’interruption, des fichiers temporaires peuvent rester.

/wp-content/upgrade/
→ vérifier qu'il n'est pas bloqué par des permissions
→ supprimer le contenu temporaire si nécessaire

Exemple technique : purge cache (plugin + CDN)

Sinon la page de maintenance peut rester affichée même après suppression.

1) Purge cache du plugin (WP Rocket / LiteSpeed Cache)
2) Purge cache Cloudflare (si actif)
3) Recharger en navigation privée

Vérifications après correction

• Accès au front-end (page d’accueil + 1 page interne).
• Accès /wp-admin et chargement des pages Plugins/Thèmes.
• Test du formulaire principal (si présent) et e-mails transactionnels.
• Contrôle rapide des erreurs serveur sur 15 à 30 minutes.

Causes fréquentes identifiées

• Timeout PHP pendant une mise à jour.
• Permissions insuffisantes sur wp-content.
• Espace disque faible, surtout sur mutualisé.
• Cache agressif qui masque la correction.

Prévention mise en place

• Mettre à jour par lots (pas 25 plugins d’un coup).
• Faire une sauvegarde avant maintenance, puis valider 3 pages clés.
• Si possible: utiliser un staging pour tester les mises à jour.
• Surveiller la santé du serveur (disque, logs, timeout).

Points clés à retenir

• Un site bloqué en maintenance se résout souvent en supprimant .maintenance, mais il faut ensuite terminer proprement les mises à jour.
• Le cache peut faire croire que le problème persiste, d’où l’importance de purger et tester en privé.
• Les mises à jour par lots et une routine de vérification réduisent fortement ce type d’incident.