WordPress · Fehlerbehebung
Update fehlgeschlagen oder hängt im Wartungsmodus
Nach einem Update zeigt Ihre Website nur noch den Hinweis, dass sie wegen Wartungsarbeiten kurz nicht verfügbar ist. Oder das Update bricht mit einer Fehlermeldung ab und lässt sich nicht erneut starten.
Meistens ist dabei nur eine Datei liegen geblieben, die WordPress für die Dauer des Updates anlegt, und Ihre Inhalte sind nicht betroffen. Die Seite ist in der Regel nach wenigen Minuten wieder da. Danach bringen Sie das Update in Ruhe zu Ende.
Wartungsmeldung: eine Datei
Die Meldung verschwindet oft nach etwa zehn Minuten von selbst. Bleibt sie stehen, löschen Sie eine einzige Datei, per FTP, also über den Dateizugang zu Ihrem Webspace, oder im Dateimanager Ihres Hosters.
Halbes Plugin: frische Kopie
Ein nur halb eingespieltes Plugin ersetzen Sie durch eine frische Kopie. Die Einstellungen bleiben dabei erhalten.
Vor dem zweiten Anlauf sichern
Ein Update, das einmal abgebrochen ist, scheitert leicht ein zweites Mal an derselben Stelle.
Die Seite zeigt nur noch die Wartungsmeldung
In deutschen Installationen lautet der Hinweis: „Wegen Wartungsarbeiten ist diese Website kurzzeitig nicht verfügbar. Schau in einer Minute nochmal vorbei.“ Je nach WordPress-Version und Sprachpaket weicht der Wortlaut leicht ab, auf Englisch steht dort „Briefly unavailable for scheduled maintenance. Check back in a minute.“
Vor jedem Update legt WordPress im Hauptverzeichnis eine Datei namens .maintenance an. Solange sie da ist, sehen Besucher die Wartungsmeldung. Läuft das Update durch, löscht WordPress die Datei wieder. Bricht es vorher ab, bleibt sie liegen.
Normalerweise beachtet WordPress eine solche Datei nur etwa zehn Minuten lang. Bleibt die Meldung länger stehen, entfernen Sie die Datei von Hand:
- Verbinden Sie sich per FTP oder über den Dateimanager Ihres Hosters. Wechseln Sie in das Verzeichnis, in dem auch wp-config.php und die Ordner wp-admin und wp-content liegen.
- Schalten Sie versteckte Dateien ein. Der Punkt am Anfang macht .maintenance in vielen Programmen unsichtbar.
- Löschen Sie die Datei .maintenance. Danach ist Ihre Website sofort wieder erreichbar.
- Leeren Sie den Cache, wenn die Meldung trotzdem bleibt. Viele Websites nutzen einen Cache, also einen Zwischenspeicher für fertige Seiten, und der kann die Wartungsmeldung noch eine Weile ausliefern. Leeren Sie den Cache Ihres Caching-Plugins und, falls Ihr Hoster einen anbietet, den Server-Cache im Kundenmenü. Prüfen Sie die Seite danach in einem privaten Browserfenster.
- Prüfen Sie im Backend, ob das Update durchgelaufen ist. Unter Dashboard und Aktualisierungen sehen Sie, was noch aussteht. Spielen Sie das Ausstehende einzeln nach.
Meldung: Ein weiteres Update wird bereits ausgeführt
Diese Meldung erscheint, wenn ein vorheriger Vorgang abgebrochen ist. WordPress merkt sich das in der Datenbank und sperrt weitere Updates, damit sich nicht zwei Vorgänge in die Quere kommen. Die Sperre löst sich nach etwa 15 Minuten von selbst. Warten Sie diese Zeit ab, bevor Sie irgendetwas in der Datenbank anfassen.
Das Update bricht mit einer Fehlermeldung ab
| Meldung oder Verhalten | Mögliche Ursache |
|---|---|
| Verzeichnis konnte nicht angelegt werden | Auf dem Webspace fehlen Schreibrechte, oder der Speicher ist voll. |
| Download fehlgeschlagen | Der Server kommt nicht an die Update-Quelle heran, oft wegen einer Firewall oder einer kurzen Störung. |
| Update eines gekauften Plugins oder Themes scheitert, oft mit dem Hinweis, das Paket sei nicht verfügbar | Die Lizenz ist abgelaufen oder für diese Domain nicht aktiviert. Premium-Erweiterungen holen ihre Updates vom Server des Herstellers, und der liefert ohne gültige Lizenz nichts aus. Prüfen Sie im Kundenkonto beim Hersteller, ob die Lizenz noch läuft, und tragen Sie den Lizenzschlüssel gegebenenfalls in den Plugin-Einstellungen neu ein. |
| Das Update läuft minutenlang ohne Rückmeldung und bricht dann ab | Das Zeit- oder Speicherlimit von PHP, der Programmiersprache hinter WordPress, ist erreicht. Das betrifft häufig große Plugins auf knapp bemessenen Paketen. |
| Nach dem Update fehlen Funktionen | Die Dateien sind nur teilweise eingespielt worden. |
Seit Version 6.3 legt WordPress vor einem Plugin-Update eine vorübergehende Kopie der bisherigen Version an. Scheitert das Update unterwegs, spielt WordPress diese Kopie automatisch zurück, und das Plugin läuft in der alten Version weiter. Ein halb eingespieltes Plugin kommt dadurch seltener vor als früher.
Das greift allerdings nicht in jedem Fall. Fehlt etwa der Speicherplatz für die Kopie oder bricht der Vorgang auf dem Server komplett ab, zum Beispiel am Zeitlimit, kann WordPress nichts mehr zurückspielen. Und läuft das neue Plugin zwar vollständig, verträgt sich aber nicht mit dem Rest der Website, gilt das Update als gelungen und es wird nichts zurückgenommen.
Ein halb eingespieltes Plugin reparieren
Läuft ein Plugin nach dem Abbruch nicht mehr richtig, ersetzen Sie es durch eine vollständige Kopie. Laden Sie die aktuelle Version herunter, löschen Sie per FTP in wp-content/plugins den alten Ordner und laden Sie den neuen hoch. Ihre Einstellungen bleiben dabei erhalten, weil WordPress sie in der Datenbank speichert.
Manche Plugins speichern hochgeladene Dateien in ihrem eigenen Ordner, zum Beispiel Anhänge aus Formularen. Laden Sie den Ordner deshalb vorher herunter. Dann können Sie diese Dateien bei Bedarf zurückspielen.
Wenn Updates öfter hängen bleiben
Typische Gründe sind:
- eine veraltete PHP-Version
- ein Paket mit sehr knappem Speicher
- ein Sicherheits-Plugin, das Schreibzugriffe blockiert
- ein Browserfenster, das während des Updates geschlossen wurde
Bei Seiten, die ich neu übernehme, liegt es meistens am Hostingpaket, weil Speicher oder Zeitlimit zu knapp eingestellt sind. Fragen Sie in dem Fall Ihren Hoster nach den Limits Ihres Pakets. Ein etwas größerer Tarif kostet auf Dauer meist weniger als die Nachbereitung nach jedem Abbruch.
Bis wohin Sie selbst reparieren sollten
Die Wartungsdatei zu löschen und ein einzelnes Plugin zu ersetzen, schaffen Sie mit Dateizugang meistens selbst. Anders sieht es aus, wenn das Update von WordPress selbst mittendrin abgebrochen ist und das Backend nicht mehr lädt. Wie sich die Kerndateien dann ersetzen lassen, steht unter Weiße Seite nach einem Update, machen Sie das aber nur mit einer aktuellen Sicherung.
Holen Sie sich Hilfe, wenn es keine Sicherung gibt oder wenn ein Shop betroffen ist. Ein WooCommerce-Update baut zum Beispiel auch die Datenbank um, und bricht es dabei ab, stehen Bestellungen und Kundendaten auf dem Spiel. In solchen Fällen sehe ich mir die Seite an, bevor weiter probiert wird. Schreiben Sie mir dazu über die Kontaktseite.
Häufige Fragen
Gehen dabei Daten verloren?
Nein, normalerweise nicht. Beiträge, Seiten und Einstellungen liegen in der Datenbank, und ein abgebrochenes Update rührt sie nicht an. Vorsicht ist nur bei Dateien geboten, die ein Plugin in seinem eigenen Ordner ablegt, darauf geht der Hinweis weiter oben ein.
Merken Besucher etwas davon?
Ja, solange die Wartungsmeldung steht, sehen alle Besucher nur diesen Hinweis, auch Google. Ein paar Minuten sind unproblematisch. Bleibt die Meldung über Stunden stehen, gehen Anfragen und Bestellungen in dieser Zeit verloren.
Wie lange ist die Seite weg?
Hängt nur die Wartungsmeldung, ist das in wenigen Minuten erledigt. Länger dauert es, wenn ein Plugin nur teilweise eingespielt wurde oder Updates immer wieder abbrechen, weil dann erst die Ursache beim Hosting gefunden werden muss.
Passiert das beim nächsten Update wieder?
Ein einzelner Abbruch, etwa weil das Browserfenster zu früh geschlossen wurde, bleibt meist ein Einzelfall. Passiert es öfter, steckt fast immer eine dauerhafte Ursache dahinter, und die verschwindet nicht von allein.
Hilfe anfragen
Soll ich nachsehen, was das Update hinterlassen hat?
Nach einem Abbruch ist oft unklar, welche Dateien schon neu sind und welche noch alt. Ich gleiche das ab und schreibe Ihnen, was fehlt und mit welchem Aufwand es sich nachziehen lässt. Wenn Sie zustimmen, spiele ich die fehlenden Teile ein und prüfe danach Formular und Shop.
Hängen Updates bei Ihnen öfter, sehe ich mir auf Wunsch auch die Einstellungen Ihres Hostingpakets an.
Weitere Anleitungen und Einschätzungen finden Sie im Ratgeber.
