Warum hängt WordPress nach einem Update im Wartungsmodus?

Kläre zuerst im Hosting-Panel, ob das Update wirklich beendet ist. Wenn der Vorgang abgebrochen wurde und ein aktuelles Backup bereitsteht, kann ein berechtigter Administrator die verwaiste Datei .maintenance im WordPress-Stamm entfernen. Prüfe danach Frontend, Backend und die betroffene Version. Eine wieder erreichbare Seite allein bestätigt kein vollständiges Update.

Woran erkennst du das Problem?

Startseite und /wp-admin zeigen dieselbe Wartungsmeldung. Bei der Standardmeldung von WordPress kommt typischerweise HTTP 503 zurück. Ein Wartungs-Plugin, das Hosting oder eine Kopie im CDN-Cache kann eine ähnliche Meldung anzeigen.

Was du vor Änderungen brauchst

Halte Update-Uhrzeit, betroffene Komponenten und die letzte bekannte funktionierende Version fest. Stelle ein brauchbares Backup von Dateien und Datenbank bereit. Verwende für Dateizugriff das Hosting-Panel oder freigegebenes SFTP und teste ein erneutes Update möglichst auf einer geschützten Kopie.

Schritt für Schritt zur Lösung

  1. Aktiven Vorgang ausschließen

    Prüfe Update-Verlauf, Hosting-Auftrag oder Deployment-Protokoll. Wenn der Betreiber noch Aktualisierungsaktivität sieht, lass den Vorgang laufen und starte keinen zweiten.

  2. Echte WordPress-Installation identifizieren

    Öffne im Dateimanager den Ordner mit wp-admin und wp-includes. Achte darauf, dass Domain, Umgebung und Pfad zur ausgefallenen Installation gehören. Lass versteckte Dateien anzeigen.

  3. Verwaiste Wartungsdatei entfernen

    Entferne nur die Datei .maintenance aus diesem Ordner, nachdem der Abbruch bestätigt ist. Prüfe den Abruf in einem privaten Browserfenster. Lässt sich die Datei nicht ändern, arbeite mit dem zuständigen Hoster.

  4. Updatezustand einordnen

    Vergleiche im Backend die angezeigte Version und den Status der Erweiterung mit dem Änderungsplan. Prüfe Protokolle zum Zeitpunkt des Updates. Wiederhole die Aktualisierung erst nach Eingrenzung der Störung und einem erfolgreichen Test.

  5. Kritische Wege testen

    Öffne als Besucher eine Inhaltsseite und als berechtigter Nutzer das Backend. Verifiziere gezielt, was die aktualisierte Komponente liefert, etwa Menü, Anzeige oder Editor.

Praxisbeispiel

Bei einem Handwerksbetrieb erscheint nach einem Theme-Update auf jeder URL die Standardmeldung. Der Hoster bestätigt, dass der Auftrag abgebrochen wurde. Nach Entfernen der verwaisten Datei ist die Startseite wieder da, die Desktop-Navigation bleibt jedoch fehlerhaft. Der Betreiber stellt die vorherige Theme-Version über den vorgesehenen Wiederherstellungspunkt her und testet das Update später auf der Kopie.

Typische Fehler

  • Die Datei während eines laufenden Updates entfernen.
  • In der falschen Installation oder im Ordner wp-content suchen.
  • Den Wartungsmodus mit einer vollständigen Wiederherstellung verwechseln.

Ergebnis prüfen und Änderungen zurücknehmen

Erfolgskontrolle

Rufe Startseite, eine Unterseite und das Backend getrennt auf. Halte Statuscode, aktuelle Version und Ergebnis einer betroffenen Funktion fest. Siehst du nur im abgemeldeten Browser weiterhin die Wartungsseite, prüfe den Cache dieser URL.

Wenn die Änderung fehlschlägt

Verschlechtert sich das Ergebnis nach dem Versionswechsel, stelle die konkrete Komponente über einen geprüften Wiederherstellungsweg zurück. Falls Dateien und Datenbank gemeinsam zurückgesetzt werden müssen, kläre vorher mit dem Hoster, welche neuen Bestellungen oder Inhalte gesichert werden müssen.

Konkrete Fragen aus der Praxis

Wo finde ich .maintenance, wenn ich nicht mehr ins Dashboard komme?

Im Verzeichnis mit wp-admin und wp-includes. Im Hosting-Dateimanager muss die Anzeige versteckter Dateien meist aktiviert sein. Prüfe die Domainzuordnung des Verzeichnisses.

Kann eine abgelaufene .maintenance-Datei den Standardmodus dauerhaft einschalten?

WordPress Core berücksichtigt den darin gespeicherten Upgrade-Zeitstempel nur für ungefähr zehn Minuten. Eine länger sichtbare Seite kann von einem erneut gestarteten Prozess, einem Cache oder einem anderen Wartungsmechanismus kommen.

Woran erkenne ich einen aktiven statt verwaisten Updatevorgang?

Nutze den Status des Hosting-Auftrags und das Update-Protokoll. Eine bewegte Ladeanzeige oder geänderte Browsermeldung allein sagt nichts Verlässliches über einen Prozess auf dem Server aus.

Warum sehe ich den Wartungshinweis nur als abgemeldeter Besucher?

Bei einer Wartungsfunktion können eingeloggte Nutzer absichtlich ausgenommen sein. Ein Seitencache kann angemeldete und öffentliche Aufrufe ebenfalls unterschiedlich behandeln. Vergleiche beide Abrufe und deren Status.

Was mache ich bei einer weißen Seite direkt nach dem Entfernen?

Stoppe weitere Aktualisierungen. Gib dem Hoster URL und genaue Uhrzeit, damit er den passenden PHP-Fehler findet. Prüfe anhand des Protokolls, welche Komponente zurückgesetzt oder vollständig aktualisiert werden muss.

Wie entscheide ich, ob ich das Update erneut starte?

Wiederhole es, wenn du die Unterbrechung verstanden oder behoben hast, ein Rückweg existiert und eine vergleichbare Testkopie sauber durchläuft. Führe den Schritt in einem geeigneten Wartungsfenster aus.

Kann .maintenance fehlen, obwohl die Wartungsseite noch erscheint?

Ja. Prüfe den Wartungsmodus eines Plugins, des Hosters oder der Auslieferungsschicht. Suche nach einem dokumentierten Schalter und kläre erst, wem der sichtbare Hinweis gehört.

Warum sollte ich Cache und Wiederherstellung getrennt behandeln?

Cache-Löschung aktualisiert die Auslieferung einer bereits reparierten Seite. Bei unvollständigen Dateien behebt sie die eigentliche Ursache nicht. Prüfe deshalb zuerst den Zustand der Anwendung und leere danach gezielt den passenden Cache.

Welche Angaben braucht der Support bei einem abgebrochenen Update?

Schicke Update-Zeit mit Zeitzone, Website, betroffene Komponente, vorherige und angezeigte Version, Statuscodes und einen bereinigten Logausschnitt. Verwende den vereinbarten Supportkanal.

Wann hilft ein Ersatz einzelner Dateien gegenüber einem Vollbackup?

Wenn die betroffene Komponente eindeutig ist und keine Datenbankänderung rückgängig werden muss, kann ein gezielter Wiederherstellungsschritt frische Inhalte erhalten. Bei Unsicherheit entscheide das mit dem Hoster anhand von Logs und Backupumfang.

Gratis-Tools und Website-Checks

  • Launch-Checkliste

    Halte nach Wiederherstellung die manuell geprüften Wege fest und exportiere offene Punkte als Text.

  • Website-Checks

    Der Redirect-Check zeigt bei öffentlich erreichbaren URLs den beobachteten HTTP-Status und Weiterleitungen. Den Serverprozess kann er nicht sehen.

Häufige Detailfragen

Sind .maintenance und maintenance.php dieselbe Datei?

Nein. .maintenance signalisiert dem Core einen Updatevorgang. wp-content/maintenance.php kann die Darstellung der Core-Meldung anpassen.

Brauche ich SSH?

Nein. Ein autorisierter Hosting-Dateimanager oder freigegebenes SFTP genügt für die Datei. Hosting-Protokolle helfen bei der weiteren Diagnose.

Ist jede 503-Antwort ein abgebrochenes WordPress-Update?

Nein. 503 kann zum Beispiel auch vom Hosting kommen. Vergleiche Antworttext, Zeit und Update-Verlauf.

Quellen und Grenzen

Die Anleitung gilt für selbst gehostete WordPress-Installationen. Managed Hosting und WordPress Multisite können eigene Aktualisierungs- und Wiederherstellungswege verwenden.

Quellen geprüft am

Passende nächste Schritte