Demander un devis
Accueil/Blog/Mode de Maintenance WordPress Bloqué : Causes, Solutions et Conseils

Mode de Maintenance WordPress Bloqué : Causes, Solutions et Conseils

Grands formats 05/08/20238 min de lecture

Dernière mise à jour : septembre 2026

« Briefly unavailable for scheduled maintenance. Check back in a minute. » — si vous avez déjà vu ce message s’afficher sur votre site WordPress et refuser de disparaître, vous savez à quel point c’est stressant. Votre site est inaccessible, vos visiteurs voient une page d’erreur, et vous ne savez pas quoi faire.

Dans cet article, nous allons d’abord comprendre comment fonctionne le mode maintenance de WordPress, puis voir comment débloquer un site coincé, et enfin comment activer le mode maintenance volontairement quand vous en avez besoin.

Comment fonctionne le mode maintenance de WordPress

Quand WordPress effectue une mise à jour (plugin, thème ou cœur), il crée automatiquement un fichier nommé .maintenance à la racine de votre installation. Ce fichier contient une seule ligne :

<?php $upgrading = time(); ?>

La variable $upgrading enregistre le timestamp du début de la mise à jour. Tant que ce fichier existe, WordPress affiche le message de maintenance à tous les visiteurs. Une fois la mise à jour terminée, WordPress supprime automatiquement ce fichier et le site redevient accessible.

Le problème survient quand ce fichier n’est pas supprimé — c’est ce qui provoque le blocage en mode maintenance.

Pourquoi un site reste bloqué en mode maintenance

Plusieurs situations peuvent empêcher WordPress de supprimer le fichier .maintenance et de sortir du mode maintenance :

Mise à jour interrompue

C’est la cause la plus fréquente. Vous lancez une mise à jour et fermez l’onglet du navigateur, perdez votre connexion internet ou naviguez vers une autre page avant la fin du processus. WordPress n’a pas eu le temps de terminer proprement et de supprimer le fichier.

Ressources serveur insuffisantes

Si votre serveur manque de mémoire PHP ou atteint un timeout, le script de mise à jour s’arrête avant d’avoir terminé. C’est courant sur les hébergements mutualisés bon marché, surtout quand plusieurs plugins sont mis à jour simultanément.

Conflit entre plugins ou thèmes

Un plugin incompatible avec la nouvelle version d’un autre plugin ou du cœur de WordPress peut provoquer une erreur fatale pendant la mise à jour. Le processus s’interrompt et le fichier .maintenance reste en place.

Permissions de fichiers incorrectes

Si WordPress n’a pas les droits d’écriture nécessaires sur le répertoire racine, il ne peut pas supprimer le fichier .maintenance même après une mise à jour réussie.

Débloquer un site coincé en mode maintenance

Étape 1 : Supprimer le fichier .maintenance

C’est la solution directe dans 90 % des cas. Connectez-vous à votre serveur par FTP (avec FileZilla par exemple) ou via le gestionnaire de fichiers de votre panneau d’hébergement (cPanel, ServerAvatar, etc.) :

  1. Naviguez jusqu’à la racine de votre installation WordPress (là où se trouvent wp-config.php et wp-content/)
  2. Cherchez le fichier .maintenance — attention, c’est un fichier caché (il commence par un point). Activez l’affichage des fichiers cachés dans votre client FTP ou gestionnaire de fichiers
  3. Supprimez ce fichier
  4. Rechargez votre site dans le navigateur

Votre site devrait être de nouveau accessible immédiatement.

Étape 2 : Vider le cache

Si le site ne revient toujours pas après la suppression du fichier, videz le cache à plusieurs niveaux :

  • Cache navigateur : Ctrl+Shift+R (ou Cmd+Shift+R sur Mac) pour forcer un rechargement complet
  • Cache serveur : si vous utilisez un plugin de cache (WP Rocket, LiteSpeed Cache, W3 Total Cache), purgez-le depuis le tableau de bord ou en renommant temporairement le dossier du plugin dans wp-content/plugins/
  • Cache CDN : si vous êtes derrière Cloudflare ou un autre CDN, purgez le cache depuis leur interface

Étape 3 : Identifier un plugin ou thème fautif

Si le site revient mais avec des erreurs, ou si le problème se reproduit à chaque tentative de mise à jour, un plugin ou thème est probablement en cause :

  1. Via FTP, renommez le dossier wp-content/plugins/ en plugins-disabled/ — cela désactive tous les plugins d’un coup
  2. Vérifiez que le site fonctionne
  3. Renommez le dossier en plugins/ puis désactivez les plugins un par un depuis le tableau de bord pour identifier le coupable
  4. Mettez à jour ou remplacez le plugin problématique

La même méthode fonctionne pour les thèmes : renommez le dossier de votre thème actif dans wp-content/themes/ pour forcer WordPress à revenir sur un thème par défaut.

Étape 4 : Vérifier les permissions de fichiers

Les permissions recommandées pour une installation WordPress sont :

  • Dossiers : 755
  • Fichiers : 644
  • wp-config.php : 600 ou 640

Si les permissions sont trop restrictives, WordPress ne peut ni écrire ni supprimer de fichiers. Corrigez-les via FTP ou en ligne de commande :

find /chemin/vers/wordpress -type d -exec chmod 755 {} \;
find /chemin/vers/wordpress -type f -exec chmod 644 {} \;

Activer le mode maintenance volontairement

Il y a des situations où vous voulez mettre votre site en maintenance : une refonte en cours, un changement de serveur, une modification importante du contenu. Voici les méthodes propres pour le faire.

Méthode 1 : Utiliser un plugin de maintenance

C’est la méthode la plus simple et la plus flexible. Les plugins populaires incluent WP Maintenance Mode, SeedProd et LightStart. Ils permettent de :

  • Personnaliser la page de maintenance (logo, texte, compte à rebours, formulaire d’email)
  • Autoriser certaines IP ou utilisateurs connectés à voir le site normalement
  • Ajouter des liens vers vos réseaux sociaux
  • Activer/désactiver le mode maintenance en un clic

C’est la méthode recommandée pour la plupart des cas, surtout si vous souhaitez une page de maintenance soignée et professionnelle.

Méthode 2 : Créer un mu-plugin

Si vous préférez une solution sans plugin tiers, créez un fichier dans wp-content/mu-plugins/ (créez le dossier s’il n’existe pas). Les mu-plugins (must-use plugins) sont chargés automatiquement et ne peuvent pas être désactivés depuis le tableau de bord — ce qui en fait un bon emplacement pour une maintenance contrôlée.

Créez un fichier nommé maintenance-mode.php :

<?php
/*
 * Plugin Name: Mode Maintenance
 * Description: Active le mode maintenance pour les visiteurs non connectés.
 */
if ( ! is_user_logged_in() ) {
    wp_die(
        '<h1>Site en maintenance</h1><p>Nous effectuons une mise à jour. Merci de revenir dans quelques instants.</p>',
        'Maintenance en cours',
        array( 'response' => 503 )
    );
}

Important : le code renvoie un statut HTTP 503 (Service Unavailable), ce qui indique aux moteurs de recherche que l’indisponibilité est temporaire et qu’ils ne doivent pas désindexer vos pages. Pour désactiver la maintenance, supprimez simplement ce fichier du dossier mu-plugins/.

Pourquoi pas functions.php ? Modifier le fichier functions.php de votre thème est risqué : une erreur de syntaxe peut rendre le site entièrement inaccessible, et le code sera perdu lors d’une mise à jour du thème. Un mu-plugin est plus sûr et indépendant du thème.

Méthode 3 : Le fichier .maintenance manuel

Pour une maintenance très rapide (quelques minutes), vous pouvez créer manuellement le fichier .maintenance à la racine de WordPress :

<?php $upgrading = time(); ?>

WordPress affichera son message de maintenance natif. Pour remettre le site en ligne, supprimez simplement le fichier. Cette méthode est brutale mais efficace pour une intervention rapide en ligne de commande.

Attention : WordPress considère le mode maintenance comme expiré si le timestamp a plus de 10 minutes. Après ce délai, le site redevient accessible même si le fichier existe toujours. Pour une maintenance plus longue, utilisez plutôt un plugin ou un mu-plugin.

Prévenir les blocages en mode maintenance

  • Ne fermez jamais l’onglet pendant une mise à jour WordPress. Attendez que le processus soit terminé et que le message de confirmation s’affiche
  • Sauvegardez avant chaque mise à jour majeure. Un snapshot complet (fichiers + base de données) vous permettra de restaurer rapidement en cas de problème
  • Mettez à jour régulièrement. Plus vous attendez entre les mises à jour, plus le risque d’incompatibilité augmente. Des mises à jour fréquentes et incrémentales sont plus sûres qu’une grosse mise à jour après des mois de retard
  • Testez en staging. Avant d’appliquer des mises à jour sur votre site en production, testez-les sur un environnement de staging. La plupart des panneaux d’hébergement modernes (ServerAvatar, cPanel, Plesk) proposent cette fonctionnalité
  • Augmentez les limites PHP si vous êtes sur un serveur que vous gérez. Un memory_limit de 256M et un max_execution_time de 300 secondes réduisent considérablement les risques de timeout pendant les mises à jour

Conclusion

Le mode maintenance de WordPress est un mécanisme de protection utile, mais qui peut devenir un piège quand il ne se désactive pas. Dans la grande majorité des cas, supprimer le fichier .maintenance à la racine suffit à débloquer la situation. Pour les cas plus complexes, le problème vient généralement d’un plugin incompatible ou de ressources serveur insuffisantes.

Et quand c’est vous qui avez besoin de mettre votre site en pause, utilisez un plugin dédié ou un mu-plugin plutôt que de bricoler dans les fichiers du thème — c’est plus propre et plus sûr.

Si votre site est bloqué en maintenance et que vous ne parvenez pas à le débloquer, ou si vous souhaitez mettre en place une stratégie de mise à jour sécurisée, nous pouvons vous aider.

← Tous les articles Parlons de votre projet