Häufige Fehlerquellen

Auf dieser Seite findest du häufige Fehlerquellen, wofür wir wöchentlich Anfragen bekommen. Die meisten Fehlerquellen sind auf die Installation zurückzuführen und beziehen sich weniger auf die App.

APP_URL ist falsch in der .env

Auf dem Server gibt es eine .env Datei, wo eine wichtige URL bei der Variable APP_URL gespeichert ist. Diese URL wird benutzt, damit die externe App eine URL von deinem Shopware-Shop für die Kommunikation zurück enthält (es handelt sich hier um eine externe Shopware Cloud-App). Leider wird diese URL bei Self-Hosted-Shops fast immer falsch gesetzt - bereits vom Installer.

Die URL könnte ähnlich falsch stehen wie hier

APP_URL="http://127.0.0.1"

Wichtig bei der Korrektur ist es die URL des Shops zu verwenden. Unbedingt auch http & https beachten. In einigen Fällen kann es auch eine abweichende URL zum Admin des Shops sein (z.B. Shopware PWA oder mehrere Shop-Domains innerhalb einer Installation). Richtig wäre z.B.

APP_URL="https://www.mein-shop.de"

Nach der Änderung einmal die Datei speichern und den Shop Cache leeren. Nun wird im Admin ein neues Fenster erscheinen, da sich die URL geändert hat. Hier wäre eine Möglichkeit allen externen Cloud-Apps mitzuteilen, dass sich die URL geändert hat, weil der Shop "umgezogen" ist. Etwas mehr steht an dieser Stelle: https://developer.shopware.com/docs/guides/plugins/apps/app-base-guide#handling-the-migration-of-shops

Als Letztes nochmal die App neu installieren. Danach sollte alles soweit funktionieren.

Die App erreicht deinen Shop nicht (Firewall / Cloudflare)

Bei „Baum pro Bestellung (Cloud)" handelt es sich um eine externe Cloud-App: Sie läuft auf unseren Servern und kommuniziert mit deinem Shop über die Shopware-Schnittstelle (API), die dafür von außen erreichbar sein muss. Über diese Schnittstelle hält die App deine Bestellungen und Baumspenden aktuell.

Viele Shops schützen diese Schnittstelle mit einer Firewall, einem Sicherheitsdienst oder einem CDN wie Cloudflare. Das ist grundsätzlich gut — aber wenn dein Shop am Tag viele Änderungen vornimmt, entstehen entsprechend viele API-Aufrufe, und diese Schutzsysteme können unsere ganz normalen Anfragen fälschlicherweise für unerwünschten Traffic halten und blockieren. Dann kommt unsere App nicht mehr zu deinem Shop durch und es kommen keine Updates mehr an — zum Beispiel werden keine Spenden mehr erfasst (es werden keine neuen Bäume gepflanzt).

Du erkennst das meist daran, dass keine Spenden mehr erfasst werden; in den Server-Logs taucht dann eine 403 Forbidden-Meldung auf.

Um das zu verhindern, trage unsere IP-Adressen in deiner Firewall, deinem Sicherheitsdienst oder bei Cloudflare auf die Allowlist (Whitelist) ein. So werden unsere Anfragen immer als vertrauenswürdig erkannt und nie blockiert:

74.220.51.43
74.220.51.44
74.220.51.45

Falls du nicht sicher bist, wie das geht: Dein Hoster — oder wer Cloudflare für dich eingerichtet hat — kann diese drei Adressen in einer Minute hinterlegen.