
Dein Shop ist erreichbar, die Startseite lädt, Bestellungen kommen rein. Und trotzdem ist die Sitemap drei Wochen alt, neue Produkte tauchen nicht in der Suche auf und ein Teil der Bestellbestätigungen hat den Shop nie verlassen. Der Grund ist oft unspektakulär: Die Scheduled Tasks von Shopware laufen nicht mehr. Niemand bekommt eine Fehlermeldung, denn ein Task, der gar nicht startet, kann auch keinen Fehler werfen.
Stell dir einen Laden vor, in dem tagsüber alles normal aussieht: Die Tür ist offen, die Kasse funktioniert, Kunden kaufen ein. Nachts kommt eine Schicht, die Regale auffüllt, Preisschilder austauscht und den Müll rausbringt. Bleibt diese Nachtschicht weg, merkt das am ersten Morgen niemand. Nach einer Woche sind die Regale halb leer und die Preise stimmen nicht mehr. Genau das sind Scheduled Tasks für deinen Shop: die Nachtschicht, die niemand sieht.
In diesem Artikel erfährst du, was Scheduled Tasks in Shopware 6 tun, warum sie ausfallen, wie du den Fehler behebst und wie du künftig davon erfährst, bevor es deine Kunden tun.
Scheduled Tasks sind die Aufgaben, die Shopware regelmäßig im Hintergrund ausführt. Dazu gehören zum Beispiel:
Viele Plugins bringen eigene Tasks mit. In einem gewachsenen Shop laufen so schnell Dutzende Aufgaben, und an einigen davon hängt Umsatz.
Der Ablauf hat zwei Stationen, und jede kann ausfallen:
bin/console scheduled-task:run) prüft, welche Tasks fällig sind, und stellt sie als Nachricht in die Message Queue.bin/console messenger:consume) holt die Nachrichten aus der Queue und führt die eigentliche Arbeit aus.Um im Bild zu bleiben: Der Scheduler ist der Dienstplan, der Worker ist die Schicht, die tatsächlich zur Arbeit kommt. Ein Dienstplan allein füllt kein Regal.
Fällt eine der beiden Stationen aus, bleiben die Tasks liegen. Shopware merkt sich für jeden Task die nächste geplante Ausführung (next_execution_time). Liegt dieser Zeitpunkt deutlich in der Vergangenheit, ist der Task überfällig. Das ist das eindeutigste Zeichen, dass etwas nicht stimmt.
Ab Werk kann Shopware Tasks über den Browser abarbeiten, solange jemand in der Administration eingeloggt ist. Das ist für Entwicklungsumgebungen gedacht. Loggt sich am Wochenende niemand ein, passiert nichts. Das ist, als würde die Nachtschicht nur arbeiten, solange der Chef im Laden steht. Aus meiner Sicht gehört der Admin-Worker im Produktivbetrieb immer abgeschaltet und durch echte CLI-Prozesse ersetzt.
Neuer Server, neues Hosting-Paket, neue Deployment-Pipeline: Der Shop läuft, aber der Cronjob oder die Supervisor-Konfiguration wurde nicht mitgenommen. Das fällt oft erst Wochen später auf.
Ein Speicherlimit, ein fehlerhaftes Plugin oder ein Datenbank-Timeout beendet den Prozess. Ohne Supervisor oder systemd, der ihn neu startet, bleibt die Queue ab diesem Moment stehen.
Stirbt der Worker mitten in der Arbeit, kann ein Task in einem Zwischenstatus stecken bleiben. Der Scheduler plant ihn dann nicht neu ein, und alle anderen Tasks laufen weiter. Genau dieser Fall ist besonders tückisch, weil nur eine einzelne Aufgabe ausfällt.
Ein großer Import oder ein Massen-Update legt zehntausende Nachrichten in die Queue. Die Tasks werden zwar eingeplant, kommen aber nicht dran.
Die folgenden Beispiele sind konstruiert, beruhen aber auf Mustern, die wir in Shopware-Shops immer wieder sehen. Keines davon erzeugt eine Fehlermeldung.
Die neue Kollektion ist seit Montag online, der Newsletter ist raus. Nur Google bekommt davon wenig mit, weil die Sitemap seit dem Serverumzug nicht mehr neu geschrieben wurde. Die neuen Produktseiten werden deutlich später gefunden, als sie sollten, und gelöschte URLs bleiben länger im Index.
Produktexporte, zum Beispiel für Google Shopping, erzeugt Shopware über einen Scheduled Task neu. Steht der Task, laufen die Anzeigen mit den Preisen von letzter Woche weiter. Passen Feed-Preis und Shop-Preis nicht zusammen, kann das Google Merchant Center die betroffenen Artikel ablehnen, gern mitten in einer Rabattaktion.
Viele ERP-Anbindungen gleichen Bestände per Scheduled Task ab. Bleibt der Abgleich stehen, verkauft der Shop Ware, die im Lager längst weg ist. Auffällig wird es erst, wenn der Kundenservice die ersten Absagen schreiben muss.
Läuft der Mailversand über die Message Queue, bleiben die Mails liegen, sobald der Worker steht. Kunden fragen nach, ob ihre Bestellung angekommen ist, oder bestellen sicherheitshalber ein zweites Mal.
Allen Beispielen gemeinsam: Kein Absturz, keine Fehlermeldung, kein roter Balken im Monitoring. Von außen sah der Shop gesund aus. Die Nachtschicht war einfach nicht gekommen.
Die Reparatur selbst ist meist schnell erledigt. Die Folgen hängen davon ab, wie lange der Ausfall unbemerkt bleibt:
Prüfe zuerst, welche Tasks betroffen sind:
bin/console scheduled-task:list
Achte auf Tasks, deren nächste Ausführung weit in der Vergangenheit liegt, und auf Status wie queued oder running, die sich über Stunden nicht ändern. Alternativ geht der Blick direkt in die Datenbank-Tabelle scheduled_task.
Sind viele Tasks gleichzeitig überfällig, steht fast immer der Scheduler oder der Worker. Ist es ein einzelner Task, liegt das Problem meist bei genau dieser Aufgabe.
ps aux | grep -E "messenger:consume|scheduled-task:run"
Findest du keine Prozesse, ist die Ursache klar. Prüfe die Crontab beziehungsweise die Supervisor-Konfiguration auf dem Server.
In config/packages/shopware.yaml:
shopware:
admin_worker:
enable_admin_worker: false
Danach brauchst du zwei dauerhaft laufende Prozesse, idealerweise über Supervisor oder systemd, damit sie nach einem Absturz automatisch neu starten:
bin/console scheduled-task:run --time-limit=60
bin/console messenger:consume async --time-limit=60 --memory-limit=512M
Die Limits sorgen dafür, dass sich die Prozesse regelmäßig sauber beenden und frisch starten, statt langsam Speicher anzusammeln. Welche Transports dein Shop verwendet, hängt von Shopware-Version und Konfiguration ab. Gleiche die Befehle mit der Shopware-Dokumentation für deine Version ab.
Steckt ein Task dauerhaft in queued oder running, obwohl nachweislich kein Worker mehr daran arbeitet, kannst du ihn zurücksetzen:
UPDATE scheduled_task
SET status = 'scheduled', next_execution_time = NOW()
WHERE status IN ('queued', 'running')
AND next_execution_time < NOW() - INTERVAL 1 HOUR;
Mach vorher ein Backup und prüfe die betroffenen Zeilen mit einem SELECT. Setzt du einen Task zurück, der gerade tatsächlich läuft, startet er doppelt.
Zuletzt der Blick auf die Message Queue: Sinkt der Rückstau, sobald der Worker wieder läuft? Wenn nicht, blockiert eine einzelne fehlerhafte Nachricht oder der Worker scheitert an einem Plugin. Dann hilft der Blick ins Shop-Log unter var/log/.
Die Reparatur dauert meist eine halbe Stunde. Teuer wird der Ausfall, weil er tage- oder wochenlang unbemerkt bleibt. Ein klassisches Uptime-Monitoring hilft hier nicht. Der Shop antwortet ja mit HTTP 200. Die Nachtschicht meldet sich nicht krank, sie kommt einfach nicht. Stille ist keine Entwarnung.
Genau dafür gibt es in Monitorio den Check Geplante Aufgaben.
Ehrlich gesagt: Der Scheduled-Task-Check fragt, ob ein Task überfällig ist, nicht ob er fehlgeschlagen ist. Ein Task kann pünktlich laufen, jedes Mal mit einem Fehler abbrechen und brav neu eingeplant werden. Für diese Fälle kombinierst du zwei weitere Checks, die das kostenlose Plugin EmzMonitorio (MIT-Lizenz, ab Shopware 6.5.7) im Shop voraussetzen:
Zusammen ergibt das ein klares Bild: Mehrere Tasks überfällig und die Queue stagniert? Dann steht der Worker. Ein einzelner Task überfällig? Dann hängt diese eine Aufgabe. Nichts überfällig, aber Fehler im Log? Dann läuft ein Task und scheitert.
scheduled-task:run und messenger:consume als Dauerprozesse mit automatischem Neustart?Scheduled Tasks sind die Nachtschicht deines Shops. Fällt sie aus, sieht tagsüber alles normal aus, bis die Regale leer sind und die Preisschilder nicht mehr stimmen. Die Ursache ist fast immer schnell gefunden, wenn man weiß, wo man suchen muss. Entscheidend ist, dass du es überhaupt erfährst. Uptime-Monitoring sagt dir, ob dein Shop antwortet. Monitorio sagt dir, ob er verkauft und ob im Hintergrund alles läuft, was dafür nötig ist.
Teste Monitorio drei Monate lang mit einem Projekt. Verbinde deinen Shopware-Shop, aktiviere den Alarm für geplante Aufgaben und erfahre beim nächsten Ausfall als Erster davon. Zur Registrierung: https://app.monitorio.de/signup
Für Message Queue und Shop Log brauchst du zusätzlich das kostenlose Plugin: https://github.com/8mylez/EmzMonitorio
Wenn du Fragen zur Einrichtung hast oder wir uns deine Worker-Konfiguration ansehen sollen: Meld dich gern bei uns. Gemeinsam besprechen wir deine Ausgangslage und die passenden nächsten Schritte: https://www.8mylez.com/kontakt/

Noch keine Kommentare vorhanden
Was denkst du?