Shopware 6 Backend langsam: Ursachen in fester Reihenfolge prüfen und beheben
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.
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
- Woran Sie erkennen, wo es hängt
- Die Ursachen im Einzelnen
- Prüfreihenfolge: Messwert, Normalzustand, Abbruchkriterium
- Befehlsfolge zum Abarbeiten
- Wann es komplizierter wird
- Vorbeugung nach Update oder Umzug
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üfpunkt | Messwert | Normal | Auffällig | Entwickler holen, wenn |
|---|---|---|---|---|
| Admin-Worker | enable_admin_worker in config/packages/shopware.yaml; läuft ein CLI-Worker? | Admin-Worker aus, ein bis drei CLI-Worker laufen dauerhaft | Admin-Worker an, mehrere Nutzer eingeloggt, hohe CPU-Last | Sie keinen Shell-Zugang haben oder der Hoster keine dauerhaften Prozesse erlaubt |
| Queue-Rückstau | bin/console messenger:stats | Die Zahl steigt bei Arbeit kurz an und sinkt dann stetig gegen null | Die Zahl stagniert oder wächst über Minuten, obwohl Worker laufen; die Failed-Queue wächst | bin/console messenger:failed:show wiederkehrende Fehler zeigt (Speicher, Datenbank-Timeouts, Erweiterungen) |
| Geplante Aufgaben | bin/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 ein | Aufgaben hängen lange im Status queued oder running | Aufgaben trotz laufendem Worker und Cron hängen bleiben |
| Cache | Bei 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 normal | Viele Schlüssel ohne TTL, OOM-Fehler in den Logs | OOM-Fehler auftreten oder die Tags regelmäßig bereinigt werden müssen |
| Suchindex und Indexierung | Queue-Stand mit messenger:stats und Worker-Logs nach Speichern, Import oder dal:refresh:index | Nach einem Neuaufbau leert sich die Queue, die Worker melden keine Fehler | Die Queue leert sich nicht, jeder Import erzeugt neuen Stau | Importe oder Erweiterungen fortlaufend Neuindexierungen auslösen oder die Admin-Suche bei großem Bestand zu langsam bleibt |
| Datenbank | Auslastung im Hosting-Panel oder beim Hoster erfragen | Kurze Spitzen bei Importen und Indexierung | Dauerhaft hohe Last, auch bei leerer Queue | Die Last bleibt hoch, obwohl alle Punkte davor unauffällig sind. Dann müssen Abfragen analysiert werden. |
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.
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:showmessenger: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_priorityDer 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.targetDatei /etc/systemd/system/shopware_consumer.target:
[Install]
WantedBy=multi-user.target
[Unit]
Description=shopware_consumer servicesystemctl enable shopware_consumer@{1..3}.service
systemctl enable shopware_consumer.target
systemctl start shopware_consumer.targetDamit 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: falseDanach 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-waitLaut 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:warmupIn 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-queueDer 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:consumemit 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, danachbin/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:runnoch eingetragen? Ein Serverumzug kann systemd-Units und Crontab zurücklassen. - Queue regelmäßig ansehen:
messenger:statssollte 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_overwriteauf 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 begrenztebuffer_size.
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
- Shopware Developer Documentation: Message Queue, developer.shopware.com
- Shopware Developer Documentation: Scheduled Tasks, developer.shopware.com
- Shopware Developer Documentation: Performance Tweaks, developer.shopware.com
- Shopware Developer Documentation: Caches, developer.shopware.com
- Shopware Developer Documentation: Increment Storage, developer.shopware.com
- Shopware Developer Documentation: Queue Health (PaaS Monitoring), developer.shopware.com
- Shopware Developer Documentation: Commands Reference, developer.shopware.com
- Shopware Developer Documentation: Elasticsearch Setup, developer.shopware.com
- Shopware 6 Handbuch: Caches & Indizes, docs.shopware.com
- RFC 9110: HTTP Semantics, Abschnitte 15.6.3 und 15.6.5, www.rfc-editor.org
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.