Shopware & OnlineshopRedaktion Die Netzhandwerker · 18. November 2026 · 10 Min. Lesezeit

Shopware 6 Backend langsam: Ursachen in fester Reihenfolge prüfen und beheben

Hände einer Shopbetreiberin oder eines Shopbetreibers neben Lieferscheinen und einem Paket auf einem Schreibtisch im Lagerbüro, daneben ein aufgeklappter Laptop

Ein langsames Shopware-6-Backend liegt nicht zwingend an unzureichenden Serverressourcen. Eine mögliche Ursache ist die Hintergrundverarbeitung: Ab Werk arbeitet die Administration die Message-Queue im Browser ab, solange jemand eingeloggt ist. Laut Shopware-Doku erzeugt das bei mehreren Nutzern hohe CPU-Last. Gehen Sie deshalb in dieser Reihenfolge vor: Admin-Worker, Rückstau in der Queue, Cron für geplante Aufgaben, Cache, Suchindex und Indexierung, zum Schluss die Datenbank.

30 SekundenPoll-Intervall des Admin-Workers in der Konfiguration der Shopware-Doku
bis zu 3 Workergelten laut Doku ohne RabbitMQ als sinnvoll
alle 5 MinutenCron-Takt für scheduled-task:run im Doku-Beispiel
12 StundenDanach plant Shopware hängende Tasks standardmäßig neu ein

Stand 18.11.2026. Grundlage: Shopware-Entwicklerdokumentation für Version 6.7 (Message Queue, Scheduled Tasks, Caches, Increment Storage, Performance Tweaks, Queue Health, Elasticsearch, Commands Reference), das Shopware-6-Handbuch zu Caches & Indizes und die HTTP-Spezifikation RFC 9110.

Die kurze Antwort

Shopware 6 erledigt viele Aufgaben im Hintergrund über eine Message-Queue. Dazu gehören Indexierungen nach dem Speichern, Aufgaben, die nach Zeitplan laufen, und je nach Einrichtung auch der Mailversand. Wer diese Warteschlange abarbeitet und wo sie liegt, bestimmt stark, wie flüssig sich die Administration anfühlt.

Ab Werk übernimmt das der Admin-Worker: Jeder eingeloggte Browser fragt regelmäßig nach neuen Nachrichten und bearbeitet sie. Die Shopware-Doku empfiehlt, auf einem Produktivsystem stattdessen einen Worker auf der Kommandozeile zu betreiben und den Admin-Worker abzuschalten. Prüfen Sie nach Updates und Umzügen, ob der CLI-Worker noch läuft und der Admin-Worker abgeschaltet ist.

Prüfen Sie die Ursachen in einer festen Reihenfolge, von günstig und schnell bis aufwendig. Die Übersicht weiter unten nennt für jeden Schritt einen Messwert, was davon normal ist und ab wann Sie einen Entwickler brauchen.

Woran Sie erkennen, wo es hängt

Das Symptom grenzt die Ursache schon ein:

  • Die Administration ruckelt vor allem, wenn mehrere Kollegen eingeloggt sind: Das spricht für den Admin-Worker. Jeder offene Browser startet eigene Anfragen, die die Queue abarbeiten.
  • Änderungen erscheinen erst spät im Shop, Mails kommen verzögert oder die Administration meldet wartende Nachrichten: Das deutet auf einen Rückstau in der Queue hin oder darauf, dass gar kein Worker läuft.
  • Das Speichern einzelner Produkte dauert, vor allem nach Importen: Hier sind Indexierung und Suchindex verdächtig. Die Doku nennt Indexierungsnachrichten für Produkte ausdrücklich als langsam.
  • Auch die Storefront ist zäh, Fehler tauchen sporadisch auf: Dann kommen Cache-Backend oder Datenbank in Frage.
  • Speichern endet mit HTTP 504: Bei diesem Statuscode erhält ein Gateway oder Proxy nicht rechtzeitig eine Antwort vom nachgelagerten Server. Prüfen Sie die beteiligten Logs. Mehr dazu steht im Ratgeber zum 504 Gateway Timeout.

Die Ursachen im Einzelnen

Admin-Worker statt CLI-Worker

Der Admin-Worker wird in config/packages/shopware.yaml unter shopware.admin_worker konfiguriert. Der Schlüssel poll_interval legt fest, wie lange eine Anfrage die Queue abfragt. In der Konfiguration der Doku sind es 30 Sekunden. Danach endet die Anfrage, und die Administration startet sofort die nächste. Laut Doku führt das bei mehreren eingeloggten Nutzern zu hoher CPU-Last, die auch PHP-FPM ausbremsen kann.

Queue in der Datenbank

Der Standard-Transport ist Doctrine: Die Nachrichten liegen in der Shop-Datenbank. Die Doku nennt RabbitMQ als spezialisierte Alternative, die die Datenbank entlastet. Dazu kommt der Increment Storage. Er hält den Queue-Status für die Benachrichtigungen in der Administration und liegt standardmäßig in der Tabelle increment. Laufen mehrere Worker, kann diese Tabelle laut Doku sehr oft gesperrt sein, was die Worker bremst.

Geplante Aufgaben ohne Cron

Geplante Aufgaben (Scheduled Tasks) legen zu festen Zeiten Nachrichten in die Queue. Dafür muss scheduled-task:run laufen, und ein Worker muss die Nachrichten verarbeiten. Ohne Worker werden sie laut Doku zwar eingeplant, aber nicht ausgeführt.

Cache-Backend

Ab Werk liegt der Cache im Dateisystem unter var/cache. Auf einem einzelnen Server funktioniert das ohne weitere Einrichtung. Mit Redis kann der Cache voll laufen und OOM-Fehler liefern, wenn zu viele Schlüssel ohne Ablaufzeit existieren. Laut Doku entstehen solche Schlüssel durch verwaiste Cache-Tags.

Indexierung und Suchindex

Ein vollständiger Neuaufbau mit dal:refresh:index erneuert unter anderem den Produktindex und die SEO-URLs. Mit Elasticsearch oder OpenSearch kommt deren Index dazu. Mit --use-queue landet die Arbeit in der Queue. Ohne genug Worker staut sie sich dort.

Datenbank

Ist die Datenbank dauerhaft stark ausgelastet, wird laut Shopware-Doku jede Nachricht langsamer, und auch die Anfragen der Storefront leiden. Die Datenbank prüfen Sie zum Schluss, weil die Punkte davor sie häufig mitbelasten.

Prüfreihenfolge: Messwert, Normalzustand, Abbruchkriterium

Gehen Sie die Tabelle von oben nach unten durch. Behebt ein Schritt das Problem, warten Sie einen Arbeitstag ab, bevor Sie weitermachen. Die Befehle führen Sie im Shop-Verzeichnis auf dem Server aus.

Messen Sie vor und nach jeder Änderung auf dieselbe Weise: dieselbe Aktion in der Administration, etwa das Speichern eines bestimmten Produkts, deren Antwortzeit, den Verlauf von messenger:stats über einige Minuten und die Serverlast. Nur dieser Vergleich zeigt, ob ein Schritt wirkt.

PrüfpunktMesswertNormalAuffälligEntwickler holen, wenn
Admin-Workerenable_admin_worker in config/packages/shopware.yaml; läuft ein CLI-Worker?Admin-Worker aus, ein bis drei CLI-Worker laufen dauerhaftAdmin-Worker an, mehrere Nutzer eingeloggt, hohe CPU-LastSie keinen Shell-Zugang haben oder der Hoster keine dauerhaften Prozesse erlaubt
Queue-Rückstaubin/console messenger:statsDie Zahl steigt bei Arbeit kurz an und sinkt dann stetig gegen nullDie Zahl stagniert oder wächst über Minuten, obwohl Worker laufen; die Failed-Queue wächstbin/console messenger:failed:show wiederkehrende Fehler zeigt (Speicher, Datenbank-Timeouts, Erweiterungen)
Geplante Aufgabenbin/console scheduled-task:list (Terminierung und Status)Nächste Ausführung und Status passen zum Intervall; die Fehlerprotokolle zeigen keine Fehler der Aufgabe, und ihr erwartetes Ergebnis tritt einAufgaben hängen lange im Status queued oder runningAufgaben trotz laufendem Worker und Cron hängen bleiben
CacheBei Redis: redis-cli INFO keyspace (Schlüssel gesamt und mit TTL)Nach Leeren und Aufwärmen ist die Administration wieder so schnell wie vorher; ein voller Redis ist laut Doku normalViele Schlüssel ohne TTL, OOM-Fehler in den LogsOOM-Fehler auftreten oder die Tags regelmäßig bereinigt werden müssen
Suchindex und IndexierungQueue-Stand mit messenger:stats und Worker-Logs nach Speichern, Import oder dal:refresh:indexNach einem Neuaufbau leert sich die Queue, die Worker melden keine FehlerDie Queue leert sich nicht, jeder Import erzeugt neuen StauImporte oder Erweiterungen fortlaufend Neuindexierungen auslösen oder die Admin-Suche bei großem Bestand zu langsam bleibt
DatenbankAuslastung im Hosting-Panel oder beim Hoster erfragenKurze Spitzen bei Importen und IndexierungDauerhaft hohe Last, auch bei leerer QueueDie Last bleibt hoch, obwohl alle Punkte davor unauffällig sind. Dann müssen Abfragen analysiert werden.
Fortschritt ist kein Erfolgsnachweis

messenger:stats zeigt, wie viel Arbeit noch wartet. Ob sie gelungen ist, zeigen erst Worker-Logs und Failed-Queue. scheduled-task:list zeigt Terminierung und Status. Eine aktuelle letzte Ausführung belegt laut Doku keinen Erfolg, weil sie auch nach einem Fehler aktualisiert werden kann, wenn die Aufgabe neu eingeplant wird. bin/console es:status verfolgt keine DAL-Indexierung, sondern nur einen vollständigen Neuaufbau von Elasticsearch oder OpenSearch mit es:index. Auch dort kann es laut Doku completed melden, während der Aufbau noch läuft, etwa wenn noch kein Index existierte. Behandeln Sie eine Null bei messenger:stats nur als Zwischenstand: Beim Doctrine-Transport zählt der Befehl Nachrichten nicht mit, die gerade verarbeitet werden oder noch nicht wieder verfügbar sind. Prüfen Sie deshalb zusätzlich, ob die laufenden Nachrichten erfolgreich abgeschlossen wurden und ob verzögerte Wiederholungen ausstehen. Nach es:index kann bei vorhandenem Altindex außerdem noch der alte Index Suchergebnisse liefern, solange die Alias-Umschaltung aussteht. Bestätigen Sie dann, dass die Umschaltung abgeschlossen ist: es:status darf keine entsprechende Warnung mehr ausgeben.

Reihenfolge beachten

Schalten Sie den Admin-Worker erst ab, wenn ein CLI-Worker nachweislich läuft. Sonst verarbeitet niemand mehr die Queue: Indexierungen bleiben liegen, und je nach Einrichtung auch Mails. Bleiben Mails aus, hilft der Ratgeber Shopware-Mails werden nicht versendet.

Befehlsfolge zum Abarbeiten

Die Befehle stammen aus der Shopware-Entwicklerdokumentation. Ersetzen Sie /var/www/html durch Ihren Shop-Pfad und www-data durch den Benutzer Ihres Webservers.

Stand der Queue ansehen

bin/console messenger:stats
bin/console messenger:failed:show

messenger:stats zeigt, wie viele Nachrichten je Transport warten. messenger:failed:show listet die fehlgeschlagenen Nachrichten samt Fehlermeldung. Laut Doku finden Sie so am schnellsten die Ursache.

CLI-Worker testweise starten

php /var/www/html/bin/console messenger:consume --time-limit=60 --memory-limit=512M async low_priority

Der Worker beendet sich nach 60 Sekunden oder bei 512 MB Speicher. Lassen Sie parallel messenger:stats laufen: Die Zahl sollte sinken.

Worker dauerhaft per systemd betreiben

Datei /etc/systemd/system/[email protected]:

[Unit]
Description=Shopware Message Queue Consumer, instance %i
PartOf=shopware_consumer.target

[Service]
Type=simple
User=www-data
Restart=always
WorkingDirectory=/var/www/html
ExecStart=php /var/www/html/bin/console messenger:consume --time-limit=60 --memory-limit=512M async low_priority

[Install]
WantedBy=shopware_consumer.target

Datei /etc/systemd/system/shopware_consumer.target:

[Install]
WantedBy=multi-user.target

[Unit]
Description=shopware_consumer service
systemctl enable shopware_consumer@{1..3}.service
systemctl enable shopware_consumer.target
systemctl start shopware_consumer.target

Damit laufen drei Worker. Wegen Restart=always startet systemd jeden Worker neu, sobald er sich nach Zeit- oder Speicherlimit beendet. Laut Doku brauchen Sie außerdem einen Worker für die Failed-Queue, sonst werden fehlgeschlagene Nachrichten nicht verarbeitet.

Admin-Worker abschalten

# config/packages/shopware.yaml
shopware:
    admin_worker:
        enable_admin_worker: false

Danach in der Regel bin/console cache:clear ausführen, damit die geänderte Konfiguration greift.

Geplante Aufgaben per Cron anstoßen

*/5 * * * * /usr/bin/php /var/www/html/bin/console scheduled-task:run --no-wait

Laut Doku sollte der Takt zum kürzesten Intervall Ihrer Aufgaben passen. Terminierung und Status zeigt bin/console scheduled-task:list. Ob eine Aufgabe erfolgreich war, zeigen erst die Fehlerprotokolle und das erwartete Ergebnis der Aufgabe.

Cache leeren und aufwärmen

php bin/console cache:clear
php bin/console cache:warmup

In der Administration finden Sie dieselbe Funktion unter Einstellungen > System > Caches & Indizes. Das Shopware-Handbuch empfiehlt, den Cache auf einem Live-System nach dem Leeren aufzuwärmen.

Indizes über die Queue neu aufbauen

bin/console dal:refresh:index --use-queue

Der Befehl meldet schnell Erfolg, weil er nur Nachrichten einreiht. Eine leere Queue ist danach nur ein Zwischenstand. Prüfen Sie zusätzlich, ob die laufenden Nachrichten erfolgreich abgeschlossen wurden, ob verzögerte Wiederholungen ausstehen und ob die Worker Fehler protokolliert haben. Das Handbuch empfiehlt solche Läufe zu Zeiten geringer Last, etwa nachts.

Wann es komplizierter wird

Einige Fälle lassen sich nicht mit ein paar Befehlen lösen:

  • Shared Hosting ohne dauerhafte Prozesse: Ohne systemd oder einen vergleichbaren Prozessmanager kann kein CLI-Worker dauerhaft laufen. Laut Doku lässt sich messenger:consume mit Zeitlimit alternativ regelmäßig per Cron starten. Fragen Sie Ihren Hoster zuerst, ob er solche zeitlich begrenzten Aufrufe der Kommandozeile per Cron erlaubt. Cron begrenzt die Zahl laufender Worker nicht: Dauert eine Nachricht länger als das Zeitlimit, können sich Worker überlappen. Stellen Sie mit Ihrem Entwickler sicher, dass keine parallelen Worker entstehen. Erst wenn auch das nicht möglich ist, bleibt der Admin-Worker die verbleibende Standardlösung, und Sie sollten ihn nicht abschalten.
  • Admin-Suche bei großem Bestand: Die Doku beschreibt Elasticsearch und OpenSearch auch für die Administration. Ab 6.7.9.0 lassen sich Admin-API-Suche und Listen experimentell über OpenSearch bedienen (ADMIN_OPENSEARCH_URL, SHOPWARE_ADMIN_ES_ENABLED=1, ENABLE_OPENSEARCH_FOR_ADMIN_API=1, danach bin/console es:admin:index). Das setzt einen eigenen Suchdienst voraus und gehört in Entwicklerhand.
  • Indexierung bremst bei jedem Speichern: Ab 6.6.10.0 lässt sich der Product-Stream-Indexer abschalten. Die Doku nennt die Nachteile: Kategorieseiten aktualisieren sich erst, wenn der HTTP-Cache abläuft, und Line-Item-Regeln in Streams gelten immer als nicht erfüllt. Ob sich das für Ihren Shop lohnt, entscheidet besser ein Entwickler.
  • Datenbank als Engpass: Die Queue lässt sich auf RabbitMQ auslagern, der Increment Storage auf Redis. Laut Doku entlastet beides die Datenbank. Beides erfordert Eingriffe am Server.

Haben Sie die Prüfreihenfolge durchlaufen und bleibt das Backend trotzdem langsam, oder fehlt Ihnen der Zugang zum Server, finden Sie Unterstützung unter Shop-Störung beheben. Notieren Sie vorher die Ausgaben von messenger:stats, messenger:failed:show und scheduled-task:list. Das verkürzt die Fehlersuche.

Vorbeugung nach Update oder Umzug

  • Nach jedem Update prüfen: Laufen die Worker, ist der Admin-Worker aus, ist der Cron für scheduled-task:run noch eingetragen? Ein Serverumzug kann systemd-Units und Crontab zurücklassen.
  • Queue regelmäßig ansehen: messenger:stats sollte im Alltag meist nahe null stehen. Wächst die Failed-Queue, lesen Sie die Fehler, statt sie zu ignorieren.
  • Langsame und eilige Nachrichten trennen: Liegen Indexierung und zeitkritische Nachrichten wie Bestellbestätigungen im selben Transport, verzögert das eine das andere. Ab 6.6.4.0 und 6.5.12.0 lässt sich die Indexierung mit shopware.messenger.routing_overwrite auf einen eigenen Transport legen.
  • Große Läufe planen: Neuindexierungen und Importe am besten nachts starten, nicht während in der Administration gearbeitet wird.
  • Logging begrenzen: Die Performance-Hinweise der Doku empfehlen für den Produktivbetrieb das Log-Level error. Das reduziert die Protokollmenge. Gegen wachsende Logging-Puffer bei lang laufenden Jobs empfiehlt Shopware zusätzlich eine begrenzte buffer_size.
Passend dazu

Wenn die Prüfreihenfolge den Engpass zeigt, Sie ihn aber nicht selbst beheben können, etwa weil Worker, Redis oder die Datenbank am Server eingerichtet werden müssen, hilft die Leistung „Shop-Störung beheben“ für Shopify, WooCommerce und Shopware weiter.

Mehr dazu: Shop-Störung beheben: Shopify, WooCommerce, Shopware

Quellen

Alle Quellen gelesen am 18.11.2026.

Erstellt von der Redaktion Die Netzhandwerker mit KI-Unterstützung. Die Sachangaben wurden vor der Veröffentlichung automatisch gegen die genannten Quellen geprüft.

Ihr Onlineshop soll so arbeiten wie Ihr Betrieb?

Wir bauen Onlineshops als Unikat mit eigenem Quelltext und übernehmen Produkte, Kunden und Bestellungen aus Ihrem bisherigen System.

Onlineshop nach Maß ansehen →

Weiterlesen — verwandte Artikel

Onlineshop & Shopware

Shopware 6 verschickt keine Mails: Ursachen finden und in vier Stufen prüfen

Shopware Mails werden nicht versendet? Mit dieser Prüfreihenfolge finden Sie den Fehler: Mailer, Message Queue, Flow Builder und Zustellung.

Webseite & Shop

WooCommerce langsam: Ursachen der Reihe nach finden und gezielt beheben

WooCommerce langsam? Prüfen Sie Serverantwort, geplante Aktionen, autoload, HPOS, Erweiterungen und Bilder der Reihe nach, mit Warnwerten aus der Doku.

Webseite & Server

504 Gateway Timeout beheben: WordPress, Shop und Server prüfen

Der Server braucht zu lange und bricht ab? Was den 504-Fehler verursacht und wie Sie ihn beheben.

Voriger Artikel Apps ohne Play Store: Was auf SHIFT, Volla und Fairphone wirklich läuft Nächster Artikel Heatmaps für Webseiten: Sehen, wo Besucher hängen bleiben – und den Bestellweg reparieren

Beschreiben Sie Ihr Anliegen

Schreiben Sie uns kurz, worum es geht. Wir prüfen die Anfrage und melden uns per E-Mail mit dem nächsten Schritt.

Häufig gestellte Fragen

Kann ich den Admin-Worker einfach abschalten?

Erst wenn ein CLI-Worker mit messenger:consume nachweislich läuft. Sonst bleibt die Message-Queue liegen.

Wie viele CLI-Worker brauche ich?

Eine feste Zahl nennt die Shopware-Doku nicht, sie hängt von Menge und Art der Nachrichten ab. Das systemd-Beispiel startet drei Instanzen. Die Elasticsearch-Doku hält bis zu drei Worker für sinnvoll und empfiehlt darüber einen Dienst wie RabbitMQ.

Hilft es, einfach den Cache zu leeren?

Nur wenn der Cache die Ursache ist. Nach dem Leeren sind die ersten Aufrufe eher langsamer, deshalb empfiehlt das Shopware-Handbuch, auf Live-Systemen danach cache:warmup auszuführen. Läuft die Queue voll, ändert ein leerer Cache daran nichts.

Kann ich in der Administration auf „Indizes aktualisieren“ klicken?

Ja, die Funktion liegt unter Einstellungen > System > Caches & Indizes. Sie erzeugt aber spürbar Last. Starten Sie sie deshalb zu ruhigen Zeiten. Über die Auswahlfelder können Sie den Lauf auf bestimmte Indizes beschränken.

Mein Hoster erlaubt keine dauerhaften Prozesse. Was nun?

Laut Shopware-Doku lässt sich messenger:consume mit Zeitlimit alternativ regelmäßig per Cron starten. Fragen Sie Ihren Hoster, ob er solche Aufrufe erlaubt, und verhindern Sie überlappende Worker, denn Cron begrenzt deren Zahl nicht. Erst wenn auch das nicht möglich ist, bleibt der Admin-Worker die verbleibende Standardlösung. Lassen Sie ihn dann eingeschaltet.

Brauche ich Redis, damit das Backend schnell ist?

Nicht zwingend. Auf einem einzelnen Server funktioniert der Dateisystem-Cache ohne weitere Einrichtung. Redis lohnt sich bei mehreren Servern oder wenn die Tabelle increment bei mehreren Workern zum Engpass wird. Laut Doku beschleunigt Redis diese Updates.

Branchen-Fachwissen SHK, Elektro, Maler
Beispiele aus dem Haus KI-Anwendungen, die wir selbst betreiben
Alle KI-Lösungen → Alles einzeln gebaut, nichts von der Stange.
Alle Software-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Computer & Laptops PC, Mac, Kaufberatung
Mobilgeräte Smartphone, TV, Fotos
Peripherie & Netzwerk Drucker, WLAN, NAS
Alle Hardware-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Privat-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Unternehmens-Leistungen → Alles einzeln gebaut, nichts von der Stange.
linkx© Hub + Module QR-Code für digitale Abläufe
linkx© Module II Pflegeheim, Schule, Wache, Wahl
Alle Submarken → Alles einzeln gebaut, nichts von der Stange.
Alle Artikel im Wissensbereich → Alles einzeln gebaut, nichts von der Stange.