Shopware Fehler 500: Log lesen, Ursache eingrenzen und sicher beheben
Ein HTTP-500-Fehler bedeutet, dass der Server eine Anfrage wegen eines unerwarteten Fehlers nicht erfüllen konnte. Beginnen Sie mit dem Shopware-Log, standardmäßig unter var/log. Fehlt dort ein passender Eintrag, prüfen Sie das wirksame Logverzeichnis sowie die PHP- und Webserver-Logs. Die Entscheidungstabelle ordnet typische Befunde einer Maßnahme zu. Cache und Erweiterungen ändern Sie nur bei einem passenden Befund und nach einer Sicherung.
Stand 18.11.2026. Grundlage: HTTP-Standard (RFC 9110), Apache-Dokumentation zu .htaccess, Shopware-Entwicklerdokumentation (Logging, Befehlsreferenz, Hosting, Dateisystem, Projektvorlage, Update-Anleitung), Shopware-Hilfe zum Debugging, Update-Guide für 6.7, Shopware-Release-Mitteilung vom Januar 2026, MySQL-Fehlerreferenz, Symfony-Dokumentation zu Dateirechten und Umgebungsvariablen sowie die Monolog-Dokumentation zum RotatingFileHandler.
- Kurzantwort: erst das Log, dann Schritt für Schritt
- Log finden: wo Shopware den Fehler aufschreibt
- Entscheidungstabelle: Symptom oder Logzeile, Ursache, Maßnahme
- Befehlsfolge in sicherer Reihenfolge
- Debug-Modus: kurz und gezielt, nie als Dauerzustand
- Wann es komplizierter wird und Fachhilfe sinnvoll ist
- Vorbeugung: damit der nächste 500er nicht im Weihnachtsgeschäft auftritt
Kurzantwort: erst das Log, dann Schritt für Schritt
Ein HTTP-500 ist eine Sammelmeldung. Sie sagt, dass auf dem Server etwas schiefging, nicht was. Bei Shopware 6 erfahren Sie das Was in der Regel aus dem Log. Raten ist teurer als Lesen: Wer ohne Log Erweiterungen abschaltet oder Rechte verändert, verändert den Shop, ohne die Ursache zu kennen.
Geht es um einen 500er allgemein, also unabhängig von Shopware, hilft die Übersicht 500 Internal Server Error beheben. Dieser Artikel behandelt die Shopware-spezifischen Wege.
Log finden: wo Shopware den Fehler aufschreibt
Shopware nutzt Monolog zum Protokollieren. Die Logdateien liegen standardmäßig im Verzeichnis var/log der Installation. Seit Shopware 6.6.8.0 kann APP_LOG_DIR einen anderen Pfad vorgeben. Die Standardkonfiguration nutzt im Produktivbetrieb den Handler rotating_file mit dem Basispfad prod.log (Logverzeichnis und Umgebungsname, also prod). Der Handler ergänzt beim Schreiben normalerweise das Datum, die Datei heißt dann zum Beispiel prod-2026-11-18.log. Für den Standardpfad zeigt ls -lt var/log/; die neueste steht oben. Verwenden Sie in den Lesebefehlen deren tatsächlichen Namen.
cd /pfad/zum/shopware-hauptverzeichnis
ls -lt var/log/
tail -n 100 var/log/prod-2026-11-18.log
grep -i error var/log/prod-2026-11-18.logDer Befehl tail -f var/log/prod-2026-11-18.log zeigt neue Zeilen laufend an. Das ist praktisch, wenn Sie den Fehler im Browser auslösen und gleichzeitig mitlesen. Das Datum im Dateinamen ersetzen Sie jeweils durch das der aktuellen Datei.
Beispiel: eine Logzeile lesen
Das folgende Beispiel ist frei konstruiert und anonymisiert, kein Auszug aus einem realen Shop. Format und Umfang der Zeilen können je nach Version und Konfiguration abweichen; echte Zeilen sind in der Regel deutlich länger.
[2026-11-18T09:14:03.512341+01:00] request.CRITICAL: Uncaught PHP Exception Error: "Call to undefined method Beispiel\Service::berechne()" at /pfad/zum/shop/custom/plugins/BeispielPlugin/src/Service/Preis.php line 42 {"exception":"[object] (Error(code: 0): Call to undefined method Beispiel\Service::berechne() at /pfad/zum/shop/custom/plugins/BeispielPlugin/src/Service/Preis.php:42)\n[stacktrace]\n#0 /pfad/zum/shop/custom/plugins/BeispielPlugin/src/Subscriber/Preis.php(31): ...\n#1 /pfad/zum/shop/vendor/symfony/event-dispatcher/EventDispatcher.php(...): ...\n..."} []- Zeitpunkt: Der Zeitstempel am Anfang trägt eine Zeitzonenangabe. Vergleichen Sie ihn mit dem Moment, in dem Sie den Fehler ausgelöst haben, damit Sie nicht eine ältere Zeile lesen.
- Kanal und Level:
request.CRITICALnennt den Kanal und die Schwere. Im unten beschriebenen Produktionshandler isterrordie Auslöseschwelle. - Exception-Meldung: Der Typ (hier
Error) und der Text in Anführungszeichen beschreiben, was schiefging. Das beschreibt den unmittelbaren Fehler. Die eigentliche Ursache kann weiter zurückliegen. - Stelle: Hinter
atsteht Datei und Zeile, an der der Fehler auftrat. Ein Pfad untercustom/plugins/BeispielPluginnennt hier den Ordner der betroffenen Erweiterung. - Stacktrace: Nach
[stacktrace]folgt der Aufrufweg, beginnend bei#0. Ein Pfad zu einer Erweiterung oder eigenem Code zeigt zunächst deren Beteiligung am Aufruf. Prüfen Sie die Auslösestelle und gegebenenfalls die vorherige Exception.
Was im Log landet und was nicht
Der Produktionshandler im Shopware-Core 6.7.16.0 verwendet fingers_crossed mit action_level: error. Ein Treffer ab error löst die Ausgabe über den nachgelagerten Handler aus. Das Beispiel der Entwicklerdokumentation schließt 404 und 405 aus. Prüfen Sie in Ihrer wirksamen Monolog-Konfiguration, ob dieser Ausschluss eingestellt ist.
Event Logs im Admin
Ist die Administration noch erreichbar, finden Sie Einträge laut Shopware-Hilfe unter Einstellungen > System > Event Logs. Über das Menü mit den drei Punkten und View details sehen Sie die vollständige Meldung. Die Bezeichnungen in einer deutschsprachigen Oberfläche können davon abweichen. Läuft der Admin selbst in den 500er, bleibt die Konsole, sofern sie noch startet.
Logs von Erweiterungen und vom Hoster
Erweiterungen können eigene Logs oder Handler verwenden. Webserver- und PHP-Logs hängen von der Serverkonfiguration ab. Den tatsächlichen Ablageort erfahren Sie beim Hoster.
Entscheidungstabelle: Symptom oder Logzeile, Ursache, Maßnahme
Die Tabelle bündelt, was die Dokumentationen von Shopware und Symfony einzeln beschreiben. Die Spalte „Vorsicht“ sagt, wann Sie vorher sichern und wann Sie besser Fachhilfe holen. Die Zuordnung ist eine Eingrenzung: Sie nennt wahrscheinliche Ursachen, keine Garantie.
| Symptom oder Logzeile | Wahrscheinliche Ursache | Maßnahme | Vorsicht |
|---|---|---|---|
| Stacktrace nennt eine Erweiterung | Die Erweiterung war am Aufruf beteiligt | Auslösestelle und vorherige Exception prüfen. Den Fehler nach einer Änderung auf der Testkopie reproduzieren | Nur bei begründetem Verdacht die einzelne Erweiterung testweise deaktivieren. Vorher sichern |
| 500er direkt nach einem Update | Das Update kann unvollständig sein | Konkreten Logfehler und letzten erfolgreich abgeschlossenen Update-Schritt ermitteln | Den Update-Abschluss erst im dokumentierten Ablauf fortsetzen, wenn der ausstehende Schritt bestätigt ist |
| Fehler tritt nach Änderungen an Erweiterungen, Theme oder Konfiguration auf, Log ohne klare Ursache | Veralteter oder beschädigter Cache | bin/console cache:clear | Geringes Risiko. Danach prüfen, ob der Shop noch läuft (Rechte, siehe unten) |
Meldungen zu Schreibrechten, etwa „Permission denied“ bei var/cache oder var/log | Webserver- oder Konsolenbenutzer darf in var nicht schreiben | Besitzer und Rechte mit ls -ld var var/cache var/log prüfen | Rechte zu ändern ist auf Shared Hosting Sache des Hosters. Fachhilfe, wenn unklar ist, welcher Benutzer den Webserver betreibt |
| „Allowed memory size … exhausted“ | Das wirksame PHP-Speicherlimit wurde erreicht | Limit der betroffenen PHP-Laufzeit mit der Anforderung der Shopware-Version vergleichen. Bei ausreichendem Limit den Vorgang untersuchen | Web- und Konsolen-PHP können unterschiedliche Werte verwenden |
| Meldung über eine unbekannte PHP-Funktion | Möglich sind ein fehlendes Modul, eine deaktivierte Funktion oder ein Fehler im Anwendungscode | Funktionsnamen ermitteln und die Module sowie disable_functions der betroffenen Laufzeit prüfen | php -m zeigt nur die Module der Konsole |
| 500er unmittelbar nach einem PHP-Wechsel | PHP-Version, Module oder Einstellungen passen möglicherweise nicht | Bei Fehlern im Browser die wirksame Web-PHP-Version und ihre Module mit den Anforderungen der installierten Shopware-Version vergleichen | php -v prüft nur das PHP der Konsole |
| Log meldet eine nicht unterstützte Datenbankversion oder einen belegten Versionskonflikt | Datenbankversion unpassend | Version beim Hoster erfragen; die aktuelle Hosting-Doku nennt MySQL ab 8.0.22 ohne MySQL-Innovation-Releases oder MariaDB mindestens 10.11.6. Zusätzlich gelten die Anforderungen der installierten Shopware-Version; der Update-Guide für 6.7 nennt MySQL 8.0.20 und 8.0.21 sowie MariaDB 10.11.5 und 11.0.3 als problematisch | Datenbankwechsel nur mit Sicherung. Fachhilfe empfohlen |
| Allgemeiner Fehler beim Datenbankzugriff, etwa verweigerter Zugriff, unbekannte Datenbank oder zu viele Verbindungen | Steht in der konkreten Fehlermeldung; ein Versionsverdacht ergibt sich daraus nicht | Zuerst Meldung und Fehlercode im Log auswerten. Die MySQL-Fehlerreferenz führt zum Beispiel 1040 (Too many connections), 1045 (Access denied) und 1049 (Unknown database) | Datenbankänderungen nur mit Sicherung. Fachhilfe, wenn die Meldung unklar bleibt |
| 500er, aber im erwarteten Shopware-Log fehlen aktuelle Zeilen | Anderer Logpfad oder Handler, fehlende Schreibrechte oder Fehler vor dem Shopware-Logging | Wirksame Monolog-Konfiguration und Logverzeichnis prüfen. Anschließend PHP- und Webserver-Log ansehen | Zeitpunkt und Zeitzonen der Anfragen abgleichen |
Befehlsfolge in sicherer Reihenfolge
Arbeiten Sie im Shopware-Hauptverzeichnis. Die folgenden Befehle sind einzelne Prüfschritte. Wählen Sie anhand des Logs den passenden Schritt. Sichern Sie vor Änderungen Datenbank und Dateien und klären Sie den Rückspielweg.
1. Log lesen
Prüfen Sie den wirksamen Logpfad und verwenden Sie den aktuellen Dateinamen. Das Beispiel zeigt den Standardpfad mit einer Beispieldatei.
ls -lt var/log/
tail -n 100 var/log/prod-2026-11-18.log
2. Cache prüfen
Deutet der Verlauf auf einen veralteten Cache, prüfen Sie die Optionen Ihrer Installation mit bin/console cache:clear --help. Zum Leeren nutzen Sie bin/console cache:clear. Testen Sie danach den betroffenen Aufruf.
3. Einzelne Erweiterung prüfen
Shopware unterscheidet klassische serverseitige Erweiterungen und Apps. Liegt ein begründeter Verdacht auf eine klassische Erweiterung vor, ermitteln Sie ihren technischen Namen mit bin/console plugin:list. In bin/console plugin:deactivate BeispielPlugin ersetzen Sie BeispielPlugin durch diesen Namen. Apps stehen in der separaten Liste bin/console app:list. Für sie gelten die App-Befehle aus der Shopware-Referenz. Testen Sie auf einer Kopie und kontrollieren Sie die Ausgabe der Deaktivierung. Meldet der Befehl abhängige Erweiterungen, klären Sie deren Funktion vor weiteren Änderungen. Prüfen Sie anschließend den betroffenen Aufruf und bei Checkout-relevanten Erweiterungen den Checkout.
4. Schreibrechte eingrenzen
Bei einem Schreibfehler zeigt ls -ld var var/cache var/log die Rechte für die Standardpfade. Prüfen Sie, welche Benutzer für Webanfragen und Konsole tatsächlich schreiben. Symfony dokumentiert unter anderem ACLs für Installationen mit unterschiedlichen Benutzern. Auf Shared Hosting kann der Hoster Rechte auf Serverebene prüfen.
5. PHP prüfen
Die Befehle php -v, php -m und php -i | grep memory_limit prüfen ausschließlich das PHP der Konsole. Für einen Fehler im Browser vergleichen Sie die wirksame Web-PHP-Version, ihre Module und ihr Speicherlimit mit den Anforderungen Ihrer Shopware-Version.
6. Abgebrochenes Update einordnen
Ermitteln Sie anhand von Update-Protokoll und Fehlermeldung den letzten erfolgreich beendeten Schritt. bin/console system:update:finish führt unter anderem Datenbankmigrationen aus. Der Befehl gehört zum dokumentierten Update-Ablauf und kommt nur bei bestätigtem ausstehendem Abschluss infrage. Bei einem Composer-Update gehören dazu eine Sicherung, der aktive Wartungsmodus, die abgeschlossene Update-Vorbereitung und vollständig bereitgestellter Code der Zielversion.
Debug-Modus: kurz und gezielt, nie als Dauerzustand
Falls die Logs für die Diagnose nicht ausreichen, reproduzieren Sie den Fehler im Dev-Modus auf einer zugriffsgeschützten Kopie. Wenn er sich nur im laufenden Shop nachstellen lässt, beschränken Sie den Zugriff technisch auf die prüfenden Personen, bevor Sie Debugging einschalten. Detaillierte Fehlermeldungen können sensible Daten enthalten.
Prüfen Sie, welche Konfiguration für Webanfragen greift. Lokale Einstellungen können in .env.local oder in einer Datei für die jeweilige Umgebung stehen, etwa .env.prod.local. Servervariablen haben Vorrang. Wenn Symfony eine für die aktive Umgebung passende .env.local.php lädt, können Änderungen an den normalen .env-Dateien wirkungslos bleiben. Widersprechen sich die Werte, prüfen Sie die tatsächlich verwendete Quelle.
Stellen Sie nach dem Test die Produktionsumgebung wieder her, leeren Sie den Cache und prüfen Sie aus Sicht der Webanfrage, dass APP_ENV=prod aktiv und Debugging ausgeschaltet ist. Insbesondere darf kein wirksames APP_DEBUG=1 den Debug-Modus aktiv halten. Heben Sie eine Zugriffssperre erst nach dieser Prüfung auf.
Wann es komplizierter wird und Fachhilfe sinnvoll ist
Fachhilfe lohnt sich, sobald eine dieser Lagen eintritt:
- Das Log nennt eine Ursache, die Sie nicht einordnen können, etwa Datenbankfehler mitten in einem Update.
- Die verdächtige Erweiterung trägt Zahlung, Versand oder die Warenwirtschaft, und das Abschalten würde Bestellungen blockieren.
- Rechte oder PHP-Einstellungen müssen auf Serverebene geändert werden, und Sie haben keinen Zugriff.
- Die Shopware-Konsole startet selbst nicht mehr, sodass sich Erweiterungen nicht per Befehl deaktivieren lassen.
- Ein Update von 6.4 auf 6.7 wurde abgebrochen. Dazu gibt es den Beitrag Shopware 6.4 auf 6.7 aktualisieren.
- Der 500er zeigt sich nur im Checkout oder bei bestimmten Produkten und bleibt trotz Cache-Leeren bestehen.
Wenn Sie den Fehler nicht selbst eingrenzen können, hilft die Leistung Shop-Störung beheben. Legen Sie dafür den relevanten Ausschnitt aus der aktuellen Logdatei aus dem wirksamen Logverzeichnis und den Zeitpunkt der letzten Änderung bereit. Das verkürzt die Eingrenzung deutlich.
Auch ein Fehler, der Mails betrifft, hat eigene Ursachen: Dazu siehe Shopware-Mails werden nicht versendet.
Vorbeugung: damit der nächste 500er nicht im Weihnachtsgeschäft auftritt
- Vor jedem Update sichern. Datenbank und Dateien, mit einem Rückspielweg, den Sie einmal getestet haben.
- Anforderungen der Zielversion prüfen. Für 6.7 nennt der Update-Guide PHP 8.2, 8.3 und 8.4 (seit 6.7.6.0 zusätzlich PHP 8.5, laut offizieller Release-Mitteilung) und Node.js 20 oder höher. Für die Datenbank nennt die aktuelle Hosting-Doku MySQL ab 8.0.22 ohne MySQL-Innovation-Releases oder MariaDB mindestens 10.11.6; die Anforderungen der konkret installierten Shopware-Version sind ergänzend zu beachten. Die Hosting-Doku empfiehlt PHP 8.4. Prüfen Sie, ob Ihre Erweiterungen die gewählte PHP-Version ebenfalls tragen.
- Änderungen erst auf einer Kopie testen. Updates von Erweiterungen und PHP-Wechsel gehören nicht direkt in den laufenden Shop.
- Logs im Blick behalten. Shopware rotiert die Logdatei über den Handler
rotating_file; die Anzahl aufbewahrter Dateien steuertshopware.logger.file_rotation_countinconfig/packages/shopware.yaml. Die Dokumentation nennt dafür 30 als Beispiel. - Dev-Modus abschalten. Prüfen Sie nach jedem Eingriff, dass Webanfragen in der Umgebung
prodmit ausgeschaltetem Debug-Modus laufen.
Zur Einordnung der HTTP-Codes insgesamt hilft die Übersicht der HTTP-Fehlercodes.
Wenn die Eingrenzung im Log nicht gelingt oder der Shop während des laufenden Geschäfts nicht stillstehen darf, nehmen wir die Fehlersuche in Ihrem Shopware-, Shopify- oder WooCommerce-Shop auf der Seite Shop-Störung beheben auf. Sie bringen Logauszug und Zeitpunkt der letzten Änderung mit, den Rest klären wir.
Mehr dazu: Shop-Störung beheben: Shopify, WooCommerce, Shopware
Quellen
- HTTP-Standard (RFC 9110), Abschnitt 15.6.1: 500 Internal Server Error, www.rfc-editor.org
- Apache: .htaccess-Dateien, Fehlersuche, httpd.apache.org
- MySQL: Server-Fehlerreferenz, dev.mysql.com
- Shopware: Release-News Januar 2026 (PHP-8.5-Unterstützung), www.shopware.com
- Shopware-Entwicklerdokumentation: Logging, developer.shopware.com
- Shopware-Standardkonfiguration: monolog.yaml (prod), raw.githubusercontent.com
- Monolog: RotatingFileHandler, github.com
- Shopware-Entwicklerdokumentation: Commands Reference, developer.shopware.com
- Shopware-Hilfe: Debugging, docs.shopware.com
- Shopware-Hilfe: Update Guide Shopware 6.7, docs.shopware.com
- Shopware-Entwicklerdokumentation: Updates durchführen, developer.shopware.com
- Shopware-Entwicklerdokumentation: Hosting, developer.shopware.com
- Shopware-Entwicklerdokumentation: Projektvorlage mit .env.local, developer.shopware.com
- Shopware-Entwicklerdokumentation: Filesystem, developer.shopware.com
- Symfony-Dokumentation: Setting up or Fixing File Permissions, symfony.com
- Symfony-Dokumentation: Konfiguration und Umgebungsvariablen, symfony.com
- Shopware: Umgebungsvariablen und APP_LOG_DIR, developer.shopware.com
- Shopware: Konfiguration des Web-Einstiegs, github.com
- Symfony Dotenv: Auswahl der Umgebungsdateien, github.com
Alle Quellen gelesen am 19.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.