Dépannage WordPress
WordPress bloqué en maintenance : sortir proprement du mode
WordPress crée temporairement un fichier .maintenance pendant certaines mises à jour. Si le processus est interrompu, le message « Briefly unavailable for scheduled maintenance » peut rester alors que la mise à jour n’est ni terminée ni validée.
Ce que ce symptôme signifie réellement
Le message persistant est un symptôme d’interruption : délai dépassé, espace disque, droits, processus tué ou connexion coupée.
Supprimer le marqueur peut rendre le site visible, mais ne prouve pas que les fichiers et la base sont cohérents.
Avant toute modification : préserver les preuves et le retour arrière
Notez l’heure, l’URL, le message exact, le code HTTP et le dernier changement connu. Vérifiez ensuite qu’une sauvegarde récente couvre bien les fichiers et la base de données, qu’elle est lisible et qu’un retour arrière limité est possible. Une sauvegarde non testée ne suffit pas pour une intervention risquée.
- Ne transmettez jamais de mot de passe, clé privée, jeton, fichier
wp-config.phpou export de base dans un formulaire ou une capture. - Travaillez d’abord sur un staging ou une copie isolée lorsque le diagnostic exige une mise à jour, une modification de code ou une opération de base de données.
- Conservez les journaux et les fichiers suspects avant nettoyage : ils peuvent être nécessaires pour comprendre la cause ou vérifier l’étendue d’un incident.
Diagnostic : avancer du signal le plus fiable au test le moins intrusif
Vérifiez l’heure de début, le composant mis à jour, l’espace libre, les journaux et la présence du fichier de maintenance.
- Attendre quelques minutes et confirmer qu’aucun processus de mise à jour n’est actif.
- Contrôler espace disque, droits et erreurs PHP.
- Comparer versions et empreintes du cœur, du thème ou de l’extension concernés.
- Préparer le paquet précédent et le parcours de recette.
Correction : appliquer une action ciblée et réversible
Une fois le processus arrêté et la sauvegarde confirmée, retirez seulement le marqueur de maintenance puis terminez ou annulez la mise à jour de façon contrôlée.
- Supprimer le fichier
.maintenanceà la racine uniquement après vérification. - Réinstaller le paquet officiel ou restaurer la version précédente du composant incomplet.
- Purger les caches ciblés.
- Rejouer la mise à jour sur staging avant la production.
Contrôles après correction
Une page qui se recharge ne suffit pas à prouver que le problème est résolu. Contrôlez le parcours concerné, une page non connectée, l’administration, les erreurs console et réseau, les journaux serveur, le cache et les redirections. Vérifiez aussi les écrans mobile et desktop si le symptôme touchait le rendu.
- Accueil, administration et tâche cron répondent.
- Version et fichiers du composant sont cohérents.
- Aucune erreur PHP et aucun formulaire cassé.
Quand arrêter et demander une intervention
Si une migration de base a commencé ou si l’administration reste inaccessible, arrêtez les essais et restaurez le composant ou l’instantané prévu.