3 häufige Shopware 6 Fehler beheben (Cache, Indizierung, Plugin-Konflikte)

Fehler 1: Cache-bezogene Probleme

Wie sieht ein Cache-Fehler aus?

Sie haben Änderungen an Ihrem Theme oder Ihrer Konfiguration vorgenommen, aber das Storefront zeigt immer noch alte Inhalte. Oder Sie sehen Fehler wie "Unable to generate a URL" oder "Cannot find route definition."

Warum passiert das?

Shopware 6 verwendet mehrere Cache-Ebenen (App-Cache, HTTP-Cache, Redis/Datenbank-Cache). Wenn Sie Code oder Konfiguration aktualisieren, führt veralteter Cache dazu, dass das System veraltete Daten liefert oder auf Entitäten verweist, die nicht mehr existieren.

So beheben Sie es

# App-Cache leeren
bin/console cache:clear

# HTTP-Cache leeren
bin/console http:cache:clear

# Cache neu aufbauen (Warmup)
bin/console cache:warmup

redis-cli FLUSHALL

Wenn das Leeren des Caches nicht funktioniert

Wenn Cache-Befehle fehlschlagen oder der Cache bestehen bleibt, überprüfen Sie Folgendes:

• Dateiberechtigungen: Stellen Sie sicher, dass der Webserver Schreibzugriff auf var/cache/ hat. Führen Sie chmod -R 775 var/cache aus.
• CDN/Reverse-Proxy: Wenn Sie Cloudflare oder Varnish verwenden, leeren Sie auch den Cache auf dieser Ebene.
• OPcache: Starten Sie PHP-FPM neu, um den Opcode-Cache zu leeren: sudo service php8.2-fpm restart.

Fehler 2: Indizierungsfehler

Wie sieht ein Indizierungsfehler aus?

Produkte erscheinen nach dem Import nicht im Storefront, Suchergebnisse sind veraltet, oder Sie sehen Fehler wie "Entity not found" oder "No index found for entity." Das Admin-Dashboard zeigt möglicherweise "Indexing in progress" an, das bei einem bestimmten Prozentsatz hängen bleibt.

Warum passiert das?

Shopware 6 verwendet eine Data Abstraction Layer (DAL), die indizierte Versionen von Entitäten für die Leistung verwaltet. Wenn sich Produktdaten ändern (über API, Import oder Admin), muss der Index neu erstellt werden. Die Indizierung kann aufgrund von Datenkorruption, Speicherlimits oder unterbrochenen Prozessen fehlschlagen.

So beheben Sie es

# Alle Entitäten neu indizieren
bin/console dal:refresh:index

# Falls das fehlschlägt, versuchen Sie bestimmte Entitäten zu aktualisieren
bin/console dal:refresh:index --only="product.indexer"
bin/console dal:refresh:index --only="category.indexer"

Diagnose festgefahrener Indizierung

Wenn die Indizierung feststeckt oder wiederholt fehlschlägt:

1. Fehlerprotokolle überprüfen: Untersuchen Sie var/log/prod-*.log auf spezifische Indizierungsfehler. Suchen Sie nach Datenbank-Deadlocks oder Speichererschöpfung.
2. Datenintegrität überprüfen: Prüfen Sie auf verwaiste Produkt-Kategorie-Beziehungen oder fehlende Pflichtfelder:

   mysql> SELECT * FROM product WHERE parent_id IS NOT NULL AND parent_id NOT IN (SELECT id FROM product);
   -- Sollte 0 Zeilen zurückgeben. Falls nicht, haben Sie verwaiste Varianten.

3. PHP-Speicher erhöhen: Große Kataloge benötigen mehr Speicher für die Indizierung. Bearbeiten Sie php.ini:

   memory_limit = 512M  ; oder höher für große Kataloge

4. Indizierung manuell ausführen: Im Hintergrund mit nohup ausführen:

   nohup bin/console dal:refresh:index > indexing.log 2>&1 &

0 2 * * * cd /var/www/shopware && bin/console dal:refresh:index

Fehler 3: Plugin-Kompatibilitätskonflikte

Wie sieht ein Plugin-Konflikt aus?

Nach der Installation oder Aktualisierung eines Plugins treten Fehler auf wie "Class not found," "Service not found," oder komplette weiße Bildschirme. Manchmal wird das Admin-Panel unzugänglich oder bestimmte Funktionen funktionieren nicht mehr.

Warum passiert das?

Plugins können mit Ihrer Shopware-Version inkompatibel sein, mit anderen Plugins in Konflikt geraten (doppelte Service-Definitionen, Event-Subscriber-Konflikte) oder Abhängigkeiten haben, die nicht erfüllt sind. Die Plugin-Architektur von Shopware erlaubt tiefgreifende Systemmodifikationen, was bedeutet, dass schlecht programmierte Plugins die Kernfunktionalität beeinträchtigen können.

So diagnostizieren und beheben Sie es