Magento Queue-Consumers: warten beendet den Cron

August 30, 2026

Wenn der Magento-Cron «hängt», ist oft kein toter Indexer schuld, sondern ein queue:consumers:start-Prozess, der auf Nachrichten wartet und nie sauber endet. Adobe dokumentiert das Verhalten in der Message-Queue-Konfiguration: Standardmässig bleibt consumers_wait_for_messages auf 1. Der Consumer beendet sich nicht, sobald die Queue leer ist – und der Cron-Slot wirkt dauerbesetzt.

Das ist kein Security-Bulletin und keine neue CVE. Es ist Betrieb: Queue, Cron und Prozessliste müssen dieselbe Geschichte erzählen. In der Magento-2-Betreuung und dem Managed Hosting trennen wir Indexer-Schedule (siehe Indexer: Schedule ist Default) klar von Message-Queue-Consumers – beide laufen im Hintergrund, lösen aber unterschiedliche Symptome.

Was der Default wirklich macht

Magento startet Consumers über den Cron-Job consumers_runner (Stores → Configuration → Advanced → System → Cron → Consumers) bzw. über bin/magento queue:consumers:start <name>. Mit consumers_wait_for_messages = 1 bleibt der PHP-Prozess nach der letzten Nachricht am Laufen und wartet auf neue Messages. Das ist für dauerhafte Daemons unter Supervisor sinnvoll. Unter dem klassischen Minuten-Cron erzeugt es lange lebende PHP-Prozesse, doppelte Starts und «Cron stuck»-Tickets.

Ab Magento 2.4.x gibt es zusätzlich only_spawn_when_message_available. Zusammen mit consumers_wait_for_messages = 0 startet der Runner Consumer nur bei vorhandener Nachricht und beendet sie, wenn die Queue leer ist – weniger Idle-RAM auf kleineren Hosts. Das steht in der Adobe-Config-Referenz zu env.php, nicht in einem Blog-Mythos.

'queue' => [
    'consumers_wait_for_messages' => 0,
    'only_spawn_when_message_available' => 1
]

Nach einer Änderung an app/etc/env.php: Cache leeren. Alte Warte-Prozesse sterben nicht von selbst – sie müssen beendet oder durch den nächsten sauberen Start ersetzt werden.

Use Case: Checkout-Mail bleibt in der Queue

Use Case: Bestellbestätigungen kommen verspätet, Admin zeigt async.operations in «open». ps listet seit Stunden queue:consumers:start product_action_attribute.update und async.operations.all. Der Cron-Log zeigt overlappende Starts. Richtig ist: Queue-Backend prüfen (DB-Tabellen queue_message / queue_message_status oder RabbitMQ), Consumer-Liste mit bin/magento queue:consumers:list, consumers_wait_for_messages auf 0 setzen wenn der Shop per Cron und nicht per Supervisor fährt, hängende Prozesse beenden, danach eine Testbestellung und den Mail-/Export-Consumer nachweisen – nicht «Cron neu speichern und hoffen».

Cron-Runner oder Supervisor – eine Entscheidung

Zwei Betriebsmodelle, nicht mischen:

  1. Cron-Runner: Magento startet Consumers kurzlebig. Dann gehören consumers_wait_for_messages = 0 und ein sinnvolles --max-messages dazu, damit PHP-Prozesse Speicher freigeben.
  2. Supervisor / systemd: Consumers laufen als Dienst mit Autorestart. Dann darf Warten auf Messages gewollt sein; trotzdem --max-messages setzen, damit Lecks nicht über Tage wachsen.

Wer beides parallel fährt (Cron startet dieselben Namen, die Supervisor schon hält), erzeugt Lock-Kämpfe und doppelte Verarbeitung. Die Consumer-Namen aus queue:consumers:list gehören einmalig einem Orchestrierer.

Checkliste im Incident

  • bin/magento queue:consumers:list – welche Consumer existieren überhaupt?
  • ps / Prozessliste: laufen queue:consumers:start länger als erwartet?
  • app/etc/env.php: Wert von consumers_wait_for_messages und ggf. only_spawn_when_message_available.
  • Queue-Backend: DB-Queue vs. AMQP – DB-Queues brauchen den Cron weiterhin, auch wenn RabbitMQ für eigene Topics läuft.
  • Nach Fix: eine bekannte Nachricht (Order-Mail, Export, Mass-Attribute) durch die Queue jagen und Status «complete» nachweisen.
  • Cron-Gesundheit getrennt prüfen – wie in Magento- und WordPress-Crons systematisch prüfen.

Vorher / Nachher

Vorher: Mehrere queue:consumers:start-Prozesse seit Stunden, Cron wirkt blockiert, Mails und async Ops verzögert. consumers_wait_for_messages steht auf 1, niemand hat Supervisor konfiguriert.

Nachher: env.php mit Wait=0 (Cron-Modell), Cache leer, alte Consumer beendet, Testnachricht verarbeitet. Prozessliste zeigt kurze Läufe statt Dauerwarte.

Kennzahl für den Betrieb: geschlossen ist nicht «Cron-Checkbox gespeichert», sondern: nachweislich leere oder fortschreitende Queue plus Consumer-Prozesse, die zum gewählten Modell passen.

Indexer und Message-Queue sind zwei verschiedene Hintergrundsysteme. Wenn der Shop «hängt», weil Consumer warten statt zu enden, bringen wir Queue, Cron und Hosting-Prozessmodell wieder auf eine Linie. Kontaktiert uns für eine saubere Magento-Queue- und Cron-Prüfung.

Published On: 30. August 2026Categories: Blog, Magento643 wordsViews: 81

Don’t miss

  • November 16, 2026
    Hände legen ein gefaltetes Wollkleidungsstück in ein offenes Versandpaket auf einem Holztisch.
  • November 15, 2026
    Inhaber einer kleinen Bäckerei steht am Holztresen vor einem Laptop, dessen Bildschirm nicht lesbar ist. Daneben liegen ein geschlossenes Notizbuch und eine Tasse, durch das Fenster sieht man eine herbstliche Strasse.
  • November 14, 2026
    Inhaber an einem Werkstattschreibtisch hält eine Karte mit einem abstrakten Code und sieht auf dem Laptop ein schlichtes Symbol für einen unterbrochenen Link.
  • November 13, 2026
    Weisser Briefumschlag neben einem Smartphone mit Briefsymbol und einem geschlossenen Notizbuch auf einem Holztisch.
  • November 12, 2026
    Geschlossener Laptop, externe Festplatte ohne Verbindung und ein geschlossenes Notizbuch auf einem Holztisch in einem hellen Büro
  • November 10, 2026
    Drei Trinkflaschen in gedeckten Farben mit einer Lupe auf einem hellen Holztisch.