Geplante Aktionen in WooCommerce überwachen: Action Scheduler richtig nutzen

WooCommerce erledigt viele Aufgaben nicht sofort, sondern stellt sie in eine Warteschlange: Datenbank-Updates, das Nachberechnen von Statistiken, Webhooks an Warenwirtschaft oder Newsletter-Dienst und bei Abonnements sogar die Abbuchung wiederkehrender Zahlungen. Diese Warteschlange heißt Action Scheduler, im deutschen Backend „Geplante Aktionen“. Läuft sie nicht, merken Sie das oft erst Tage später, wenn Statistiken fehlen oder ein Abo nicht verlängert wurde. Diese Anleitung zeigt, wo Sie die Warteschlange finden, woran Sie Probleme erkennen, wie Sie fehlgeschlagene Aktionen auswerten und wie Sie die Verarbeitung zuverlässiger machen.

Voraussetzungen

• WordPress mit aktivem WooCommerce. Getestet mit WordPress 7.1.2, WooCommerce 11.1.2 und dem darin enthaltenen Action Scheduler.
• Die Rolle Administrator im Backend, denn die Übersicht erfordert das Recht, Optionen zu verwalten.
• Für die Befehle SSH-Zugang und WP-CLI auf dem Server.
• Für das Einrichten eines Cronjobs Zugriff auf die Crontab oder die Cronjob-Verwaltung Ihres Hosters.
• Ein aktuelles Backup der Datenbank, bevor Sie Aktionen manuell ausführen, abbrechen oder löschen.

Schritt 1: Die Übersicht der geplanten Aktionen öffnen

Laut Dokumentation von Action Scheduler erreichen Sie die Übersicht an zwei Stellen: unter Werkzeuge > Geplante Aktionen und bei aktivem WooCommerce zusätzlich unter WooCommerce > Status > Geplante Aktionen. Beide zeigen dieselbe Liste. Oben filtern Sie nach Status: „Ausstehend“, „In Bearbeitung“, „Abgeschlossen“, „Fehlgeschlagen“, „Abgebrochen“ und, falls vorhanden, „Überfällig“.

Jede Zeile zeigt den Hook, also den internen Namen der Aufgabe, dazu Status, Argumente, Gruppe, Termin und das Protokoll. Am Hook erkennen Sie meist, welches Plugin die Aktion angelegt hat. Einträge mit woocommerce_ stammen von WooCommerce, andere Präfixe von Erweiterungen wie Abo-, Versand- oder Marketing-Plugins. Über das Suchfeld finden Sie Aktionen nach Hook, Argumenten oder Abholungs-ID.

Verifizieren: Die Liste öffnet sich und zeigt mindestens abgeschlossene und ausstehende Aktionen. Ein leerer Shop hat nur wenige Einträge, ein aktiver Shop oft Hunderte.

Schritt 2: Status per WP-CLI erfassen

Für eine schnelle Kontrolle oder ein Überwachungsskript ist die Kommandozeile praktischer. WooCommerce bringt die Befehle von Action Scheduler mit:

wp action-scheduler status
wp action-scheduler action list --status=failed --fields=id,hook,group,scheduled_date
wp action-scheduler action list --status=pending --format=count

Der erste Befehl zeigt Datenspeicher, Version und je Status die Anzahl samt ältestem und neuestem Termin. Im Test sah das nach einem absichtlich fehlgeschlagenen Testauftrag so aus:

status    count  oldest                      newest
complete  2      2026-09-30 20:56:48 +0000   2026-09-30 20:55:57 +0000
pending   5      2026-09-30 18:56:28 +0000   2026-10-01 03:00:00 +0000
failed    1      2026-09-30 20:56:48 +0000   2026-09-30 20:56:48 +0000

Wichtig ist die Spalte oldest in der Zeile pending. Liegt dieser Termin weit in der Vergangenheit, arbeitet die Warteschlange nicht ab. Die Zeiten sind in UTC angegeben, in Deutschland also im Sommer zwei Stunden früher als die Ortszeit. Wie Sie WP-CLI einrichten, zeigt die Anleitung WP-CLI installieren und die wichtigsten Befehle nutzen.

Verifizieren: wp action-scheduler status gibt eine Tabelle aus. Der älteste ausstehende Termin liegt höchstens wenige Minuten in der Vergangenheit.

Schritt 3: Überfällige Aktionen richtig einordnen

Eine Aktion ist überfällig, wenn ihr Termin verstrichen ist und sie noch aussteht. Die FAQ von Action Scheduler stellt klar, dass einige überfällige Aktionen normal sind, weil WP-Cron nur bei Seitenaufrufen startet. Mehrere überfällige Aktionen, die älter als einen Tag sind, deuten dagegen auf ein Problem hin. Genau ab dieser Schwelle blendet Action Scheduler im Backend einen Hinweis ein, im Quellcode als Standardwert von einem Tag und mindestens einer Aktion hinterlegt. Die deutsche Meldung lautet sinngemäß, dass überfällige Aktionen gefunden wurden und möglicherweise ein Problem vorliegt.

Die häufigsten Ursachen sind:

• WP-Cron ist mit define( 'DISABLE_WP_CRON', true ); abgeschaltet, aber kein Ersatz-Cronjob eingerichtet.
• Die Website hat kaum Besucher, WP-Cron wird selten ausgelöst.
• Der Server kann sich selbst nicht erreichen, etwa wegen Passwortschutz, Firewall oder falscher DNS-Einträge. WP-Cron startet seine Aufgaben über einen Aufruf der eigenen Adresse.
• Eine einzelne Aktion läuft so lange, dass sie am Zeitlimit von PHP scheitert und die Warteschlange blockiert.

Wie Sie WP-Cron selbst prüfen, beschreibt die Anleitung WordPress-Cronjobs überwachen und WP-Cron-Fehler beheben. Mit wp cron event list --hook=action_scheduler_run_queue sehen Sie, ob der Auslöser für Action Scheduler eingeplant ist. Im Test lief er im Minutentakt.

Verifizieren: Der Reiter „Überfällig“ fehlt oder enthält nur Aktionen, deren Termin wenige Minuten zurückliegt.

Schritt 4: Fehlgeschlagene Aktionen auswerten

Eine fehlgeschlagene Aktion hat beim Ausführen einen Fehler gemeldet. Der Grund steht im Protokoll der Aktion. Im Backend klappen Sie dafür die Spalte „Protokoll“ auf, per WP-CLI rufen Sie es über die ID ab:

wp action-scheduler action logs 8

Im Test hatten wir eine Aktion angelegt, die absichtlich eine Ausnahme wirft. Das Protokoll zeigte den genauen Ablauf:

date                        message
2026-09-30 20:56:30 +0000   action created
2026-09-30 20:56:48 +0000   action started via WP CLI
2026-09-30 20:56:48 +0000   action failed via WP CLI: Testfehler: API nicht erreichbar

Eine zweite typische Meldung entsteht, wenn das Plugin, das die Aktion angelegt hat, deaktiviert oder gelöscht wurde: Scheduled action for firma_alt will not be executed as no callbacks are registered. Solche verwaisten Aktionen können Sie abbrechen. Bei allen anderen Fehlern entscheidet der Inhalt der Meldung. Zeitüberschreitungen bei externen Diensten lösen sich oft von selbst, dann führen Sie die Aktion erneut aus. Wiederholt sich derselbe Fehler, wenden Sie sich mit dem Protokolleintrag an den Hersteller des Plugins.

Verifizieren: Für jede fehlgeschlagene Aktion kennen Sie die Ursache und wissen, zu welchem Plugin sie gehört.

Schritt 5: Aktionen gezielt ausführen oder abbrechen

Sichern Sie vorher die Datenbank mit wp db export. Manche Aktionen verändern Bestellungen oder lösen Zahlungen aus, ein erneuter Start ist dann nicht folgenlos. Prüfen Sie bei Abo- und Zahlungs-Plugins immer zuerst, ob die Aufgabe nicht schon auf anderem Weg erledigt wurde.

wp action-scheduler action run 8
wp action-scheduler run --hooks=HOOKNAME
wp action-scheduler action cancel firma_alt --all

Der erste Befehl startet eine einzelne Aktion über ihre ID. Der zweite arbeitet alle fälligen Aktionen eines Hooks ab, den Namen ersetzen Sie durch den Hook aus der Übersicht. --hooks akzeptiert mehrere Hooks, durch Komma getrennt ohne Leerzeichen. Der dritte bricht alle ausstehenden Aktionen eines Hooks ab, im Test bestätigt mit Success: Anfrage zum Abbrechen geplanter Aktionen abgeschlossen. Im Backend führen Sie eine ausstehende Aktion über den Link Ausführen unter dem Hook aus.

Eine Beobachtung aus dem Test: Die Option --group scheiterte zunächst mit The group "firma" does not exist., obwohl Aktionen dieser Gruppe vorhanden waren. Die Installation befand sich noch in der Übergangsphase zum neuen Datenspeicher (ActionScheduler_HybridStore). Nach wp action-scheduler migrate meldete wp action-scheduler data-store den Wert ActionScheduler_DBStore, und die Gruppenfilter funktionierten. Die Übergangsphase schließt Action Scheduler normalerweise selbst im Hintergrund ab.

Verifizieren: Die ausgeführte Aktion steht danach auf „Abgeschlossen“ oder mit neuer Fehlermeldung auf „Fehlgeschlagen“. Abgebrochene Aktionen erscheinen im Reiter „Abgebrochen“.

Schritt 6: Verarbeitung zuverlässig machen

Der verlässlichste Weg ist ein echter Cronjob auf dem Server, der WP-Cron regelmäßig anstößt. Die Anleitung WP-Cron durch echten System-Cron ersetzen zeigt die Einrichtung. Bei großen Warteschlangen empfiehlt die Dokumentation von Action Scheduler ausdrücklich WP-CLI, weil dort die Zeitlimits normaler Seitenaufrufe nicht greifen. Ein zusätzlicher Eintrag in der Crontab des Dateieigentümers kann so aussehen:

*/5 * * * * /usr/local/bin/wp --path=/var/www/html action-scheduler run --batch-size=50 --batches=4 --quiet

--batch-size legt fest, wie viele Aktionen je Durchgang laufen, Standard ist 100. --batches begrenzt die Zahl der Durchgänge, damit ein Lauf nicht in den nächsten hineinreicht. Passen Sie die Werte an Ihren Server an.

Auch das Aufräumen übernimmt Action Scheduler selbst. Laut Quellcode löscht der mitgelieferte Queue Cleaner abgeschlossene und abgebrochene Aktionen nach 31 Tagen. Fehlgeschlagene Aktionen bleiben erhalten, bis Sie sie selbst entfernen. Wächst die Tabelle trotzdem stark, räumen Sie gezielt auf:

wp action-scheduler clean --status=failed --before='90 days ago'

Überwachung heißt hier: regelmäßig hinsehen. Ein Blick pro Woche auf „Fehlgeschlagen“ und „Überfällig“ genügt meist, er darf aber nicht einschlafen. Wer solche Kontrollen zusammen mit Updates und Backups abgeben möchte, kann das tun: Die WordPress-Wartung von wordpressupdate.de spielt Updates von WordPress, Plugins und Themes mit Kompatibilitätsprüfung ein und sichert die Website wöchentlich auf externen Speicher.

Verifizieren: Nach einem Tag zeigt wp action-scheduler status keine ausstehenden Aktionen mit altem Termin, und im Backend erscheint kein Hinweis auf überfällige Aktionen.

Typische Fehler

Meldung oder Symptom	Ursache	Lösung
Hinweis auf überfällige Aktionen im Backend	WP-Cron läuft nicht oder zu selten	Echten Cronjob einrichten, DISABLE_WP_CRON prüfen
will not be executed as no callbacks are registered	Zugehöriges Plugin deaktiviert oder gelöscht	Plugin wieder aktivieren oder Aktionen mit action cancel HOOK --all abbrechen
The group "…" does not exist.	Migration auf den neuen Datenspeicher nicht abgeschlossen	wp action-scheduler data-store prüfen, bei Bedarf wp action-scheduler migrate
Viele Aktionen „In Bearbeitung“, die nie fertig werden	Prozess am PHP-Zeitlimit oder Speicherlimit abgebrochen	Fehlerprotokoll des Servers prüfen, Aktionen per WP-CLI abarbeiten
Tabelle wp_actionscheduler_actions sehr groß	Viele fehlgeschlagene Aktionen, die nicht automatisch gelöscht werden	Ursache beheben, dann wp action-scheduler clean --status=failed

Häufige Fragen

Kann ich fehlgeschlagene Aktionen einfach löschen?

Erst wenn Sie wissen, was sie tun sollten. Eine fehlgeschlagene Abo-Verlängerung bedeutet, dass eine Zahlung nicht eingezogen wurde. Löschen beseitigt nur den Eintrag, nicht das Problem. Werten Sie das Protokoll aus, beheben Sie die Ursache und räumen Sie danach auf.

Gibt es Action Scheduler auch ohne WooCommerce?

Ja. Action Scheduler ist eine Bibliothek, die auch andere Plugins mitbringen, etwa für Formulare, Newsletter oder Backups. Dann finden Sie die Übersicht unter Werkzeuge > Geplante Aktionen. Laut FAQ lädt WordPress nur die neueste der vorhandenen Kopien. Welche das ist, zeigt wp action-scheduler version.

Ersetzt Action Scheduler WP-Cron?

Nein. Laut FAQ arbeitet Action Scheduler standardmäßig zusammen mit WP-Cron und wird von dort angestoßen. Ein zuverlässiges WP-Cron ist deshalb die Grundlage für eine funktionierende Warteschlange.

Wie viele ausstehende Aktionen sind normal?

Das hängt vom Shop ab. Entscheidend ist nicht die Zahl, sondern ob der älteste Termin aktuell bleibt. Eine lange Liste mit Terminen in der Zukunft ist unbedenklich, zehn Aktionen mit Termin von letzter Woche nicht.

Testumfang

Auf einer Testinstallation mit WordPress 7.1.2 und WooCommerce haben wir eigene Testaufträge per WP-CLI gesteuert, und alles lief wie beschrieben. Auffällig war nur, dass der Gruppenfilter erst nach abgeschlossener Migration des Datenspeichers funktionierte.

Echte Abo- oder Zahlungs-Plugins waren nicht installiert, und die Übersicht im Backend haben wir nicht im Browser durchgeklickt. Probieren Sie Eingriffe in solche Aktionen deshalb zuerst auf einer Kopie aus.

Fazit

Die geplanten Aktionen sind der Maschinenraum eines WooCommerce-Shops. Ein regelmäßiger Blick auf „Fehlgeschlagen“ und „Überfällig“, ein echter Cronjob und das Protokoll als erste Anlaufstelle bei Fehlern reichen, um Probleme früh zu erkennen. Wenn Sie diese Kontrollen samt Updates und Backups nicht selbst übernehmen möchten, hilft die WordPress-Wartung von Marcel Schönfelder.

Weiterführende Anleitungen und Quellen

• WordPress-Cronjobs überwachen und WP-Cron-Fehler beheben
• WP-Cron durch echten System-Cron ersetzen
• WooCommerce-Updates sicher einspielen
• Action Scheduler: Scheduled Actions Administration Screen
• Action Scheduler: WP CLI
• Action Scheduler: FAQ