Die zehn Fallen

1. Echte Seiten verlieren ihre SEO-Adresse

Symptom: Eine Kategorie bekommt plötzlich eine Ersatzadresse, die alte Adresse leitet mit 302 weiter.
Ursache: Shopware 6.7 erzeugt auch für Link-Kategorien (etwa Einträge im Footer) eigene SEO-Adressen. Heißt eine Link-Kategorie wie die echte Seite, schnappt sie ihr die Adresse weg.
Lösung: Vor dem ersten Neuaufbau der Adressen die Vorlage für Kategorie-Adressen so ändern, dass Link-Kategorien ausgenommen sind ({% if category.type != 'link' %}). Danach alte und neue Adressen vergleichen.

2. Nach dem Domainwechsel geht nur die Kasse nicht

Symptom: Startseite und Produkte laufen, die Kasse wirft einen Fehler 500.
Ursache: Shopware merkt sich einen Fingerabdruck aus Domain und Installationspfad. Passt er nicht mehr, scheitert die Kasse, auch ohne installierte Apps.
Lösung: app:shop-id:check, dann app:shop-id:change mit move-shop-permanently, danach den Cache leeren.

3. Umgehängte Weiterleitung landet im 404

Symptom: Eine alte Adresse soll per 301 auf eine neue Seite zeigen, liefert aber 404.
Ursache: Shopware löst Adressen über das Feld path_info auf, nicht über die Verknüpfung zum Artikel.
Lösung: Beim Umhängen path_info mitziehen und danach jede Adresse einmal abrufen.

4. Theme-Schalter lassen sich nicht ausschalten

Symptom: Eine Option im Theme bleibt sichtbar, obwohl sie abgeschaltet ist.
Ursache: 6.7 gibt Schalter als 0 und 1 an das SCSS weiter. Die übliche Abfrage != false ist bei 0 trotzdem wahr.
Lösung: auf == 1 prüfen.

5. Plugin-Menüpunkt fehlt im Admin

Symptom: Das Plugin ist aktiv, sein Menüpunkt in der Verwaltung fehlt, ohne Fehlermeldung.
Ursache: 6.7 lädt Erweiterungen der Verwaltung nur noch über den Vite-Build.
Lösung: Plugin mit 6.7-Build ausliefern. Vorsicht: Der Vite-Build leert den alten Ordner.

6. Strukturierte Daten lassen sich nicht einschalten

Symptom: feature:enable JSON_LD_DATA meldet „OK“, es passiert nichts.
Ursache: Große Feature-Schalter werden beim Start verworfen.
Lösung: über eine Umgebungsvariable oder zur Laufzeit aktivieren.

7. Alte Plugins lassen sich nicht installieren

Symptom: Installation verweigert.
Ursache: Viele Plugins sind in alten Fassungen fest auf 6.6 begrenzt.
Lösung: Vor dem Umstieg für jede Erweiterung die 6.7-Fassung besorgen, sonst Ersatz planen.

8. Die Testumgebung verschickt echte Mails

Symptom: Testbestellungen lösen Mails an echte Kunden aus, Apps verschicken Einladungen.
Ursache: Die Mail-Einstellung steht in der Datenbank, nicht in der .env. Webhooks zu Apps sind in der Kopie weiter scharf.
Lösung: In der Kopie den Mailversand in der Datenbank abschalten, Webhooks und Apps deaktivieren, Zahlarten auf Test stellen.

9. Updates am Umschalttag verstellen Einstellungen

Symptom: Nach dem Umschalten fehlen Apps, eine Zahlart steht auf Testmodus.
Ursache: Das Aktualisieren der Apps entfernt Apps ohne Ordner, manche Zahlungs-Plugins setzen beim Update den Testmodus.
Lösung: App-Ordner vorher sichern, nach jedem Update die Einstellungen der Zahlarten prüfen, Testkauf machen.

10. Google darf Seitenblätterung und Feed-Bilder nicht holen

Symptom: Google meldet gesperrte Bilder, Folgeseiten der Kategorien werden nicht erfasst.
Ursache: Eine Regel wie Disallow: /*?* in der robots.txt sperrt auch ?p= und Bildadressen mit ?ts=.
Lösung: Nur Filter-Parameter gezielt sperren, Seitenblätterung freigeben, im Feed Bildadressen ohne Parameter ausgeben.

Bonus: Änderungen direkt in der Datenbank

Wer Artikel per SQL abschaltet, sieht sie weiter in Listen und Suche, weil der Suchindex nichts mitbekommt. Wer Bestellungen per SQL übernimmt, bekommt doppelte Einträge, weil Bearbeitungsstände dieselbe ID tragen. Änderungen deshalb über Shopwares eigene Datenschicht machen.

Kurz beantwortet