Shopware 6Redaktion Die Netzhandwerker · 19. November 2026 · 10 Min. Lesezeit

Shopware Fehler 500: Log lesen, Ursache eingrenzen und sicher beheben

Techniker am Laptop mit Serverprotokoll auf dem Bildschirm

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.

prod-Datum.logLogdatei im Produktivbetrieb unter var/log; prod.log ist nur der Basispfad
PHP 8.2 bis 8.5bis 6.7.5.x höchstens 8.4, seit 6.7.6.0 auch 8.5
512MMindestwert für memory_limit laut Hosting-Doku
30 sMindestwert für max_execution_time laut Hosting-Doku

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

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.log

Der 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.CRITICAL nennt den Kanal und die Schwere. Im unten beschriebenen Produktionshandler ist error die 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 at steht Datei und Zeile, an der der Fehler auftrat. Ein Pfad unter custom/plugins/BeispielPlugin nennt 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 LogzeileWahrscheinliche UrsacheMaßnahmeVorsicht
Stacktrace nennt eine ErweiterungDie Erweiterung war am Aufruf beteiligtAuslösestelle und vorherige Exception prüfen. Den Fehler nach einer Änderung auf der Testkopie reproduzierenNur bei begründetem Verdacht die einzelne Erweiterung testweise deaktivieren. Vorher sichern
500er direkt nach einem UpdateDas Update kann unvollständig seinKonkreten Logfehler und letzten erfolgreich abgeschlossenen Update-Schritt ermittelnDen 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 UrsacheVeralteter oder beschädigter Cachebin/console cache:clearGeringes Risiko. Danach prüfen, ob der Shop noch läuft (Rechte, siehe unten)
Meldungen zu Schreibrechten, etwa „Permission denied“ bei var/cache oder var/logWebserver- oder Konsolenbenutzer darf in var nicht schreibenBesitzer und Rechte mit ls -ld var var/cache var/log prüfenRechte 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 erreichtLimit der betroffenen PHP-Laufzeit mit der Anforderung der Shopware-Version vergleichen. Bei ausreichendem Limit den Vorgang untersuchenWeb- und Konsolen-PHP können unterschiedliche Werte verwenden
Meldung über eine unbekannte PHP-FunktionMöglich sind ein fehlendes Modul, eine deaktivierte Funktion oder ein Fehler im AnwendungscodeFunktionsnamen ermitteln und die Module sowie disable_functions der betroffenen Laufzeit prüfenphp -m zeigt nur die Module der Konsole
500er unmittelbar nach einem PHP-WechselPHP-Version, Module oder Einstellungen passen möglicherweise nichtBei Fehlern im Browser die wirksame Web-PHP-Version und ihre Module mit den Anforderungen der installierten Shopware-Version vergleichenphp -v prüft nur das PHP der Konsole
Log meldet eine nicht unterstützte Datenbankversion oder einen belegten VersionskonfliktDatenbankversion unpassendVersion 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 problematischDatenbankwechsel nur mit Sicherung. Fachhilfe empfohlen
Allgemeiner Fehler beim Datenbankzugriff, etwa verweigerter Zugriff, unbekannte Datenbank oder zu viele VerbindungenSteht in der konkreten Fehlermeldung; ein Versionsverdacht ergibt sich daraus nichtZuerst 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 ZeilenAnderer Logpfad oder Handler, fehlende Schreibrechte oder Fehler vor dem Shopware-LoggingWirksame Monolog-Konfiguration und Logverzeichnis prüfen. Anschließend PHP- und Webserver-Log ansehenZeitpunkt 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 steuert shopware.logger.file_rotation_count in config/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 prod mit ausgeschaltetem Debug-Modus laufen.

Zur Einordnung der HTTP-Codes insgesamt hilft die Übersicht der HTTP-Fehlercodes.

Passend dazu

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

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.

Ihre eigene Webseite zeigt diesen Fehler?

Wir bauen Ihre Webseite neu auf, übernehmen Ihre Inhalte und halten sie danach in der Wartung: Zertifikate, Server-Fehler, Sicherungen und Updates.

Webseiten-Wartung ansehen →

Weiterlesen — verwandte Artikel

Shopware & Onlineshop

Shopware 6 Backend langsam: Ursachen in fester Reihenfolge prüfen und beheben

Shopware 6 Backend langsam? Prüfen Sie Admin-Worker, Message-Queue, Cache, Suchindex und Datenbank in fester Reihenfolge – mit Befehlen und Messwerten.

E-Rechnung

E-Rechnung abgelehnt: die häufigsten Prüffehler und wie Sie sie beheben

BR-DE-15, BR-CO-15, Schemafehler: was hinter den Fehlercodes einer abgelehnten E-Rechnung steckt, in welcher Reihenfolge Sie korrigieren und wie Sie vor dem Versand prüfen.

Kassensystem

ready2order-DATEV-Export: Fehler beheben

Kassenbuch fehlt, Transitkonto steht in der Datei, Konten passen nicht zur Kanzlei: die dokumentierten Fehlerbilder im ready2order-Buchhaltungsexport und was jeweils hilft.

Voriger Artikel WooCommerce-Schnittstelle zur Warenwirtschaft: REST-API, Webhook, CSV oder Connector? Nächster Artikel Shopware 6 Backend langsam: Ursachen in fester Reihenfolge prüfen und beheben

Beschreiben Sie Ihr Anliegen

Schreiben Sie uns kurz, worum es geht. Wir prüfen die Anfrage und melden uns per E-Mail mit dem nächsten Schritt.

Häufig gestellte Fragen

Wo finde ich das Log bei Shopware 6?

Standardmäßig unter var/log. Seit Shopware 6.6.8.0 kann APP_LOG_DIR den Pfad ändern. Im Produktivbetrieb trägt die rotierte Logdatei üblicherweise das Datum im Namen.

Warum ist das Log leer, obwohl der Shop einen 500er zeigt?

Prüfen Sie den wirksamen Logpfad, den Handler und die Schreibrechte. Tritt der Fehler vor dem Anwendungslogging auf, suchen Sie anhand von Zeitpunkt und Anfrage im PHP- oder Webserver-Log.

Kann ich eine Erweiterung deaktivieren, wenn die Administration nicht lädt?

Wenn die Konsole startet, können Sie eine klassische serverseitige Erweiterung mit plugin:deactivate deaktivieren. Für Apps gibt es separate Befehle. Sichern Sie vorab und kontrollieren Sie die Ausgabe. Wird die Deaktivierung einer klassischen Erweiterung abgelehnt, prüfen Sie die gemeldeten Abhängigkeiten.

Darf ich APP_ENV=dev im Shop stehen lassen?

Testen Sie mit Debugging auf einer zugriffsgeschützten Kopie. Stellen Sie nach dem Test für Webanfragen APP_ENV=prod und ausgeschaltetes Debugging sicher. Ein wirksames APP_DEBUG=1 kann Debugging aktiv halten.

Welche PHP-Version braucht Shopware 6.7?

Für Shopware 6.7.0.0 bis 6.7.5.x nennt der Update-Guide PHP 8.2, 8.3 und 8.4; seit 6.7.6.0 wird laut offizieller Release-Mitteilung zusätzlich PHP 8.5 unterstützt. Die Hosting-Dokumentation gibt PHP 8.2 oder höher als Mindestversion und empfiehlt 8.4. Für andere Shopware-Versionen gelten andere Anforderungen, die Sie in der Dokumentation der jeweiligen Version nachlesen.

Der 500er tritt nur im Checkout auf. Was ist der Ansatz?

Lösen Sie den Fehler möglichst kontrolliert im Testshop aus und vergleichen Sie den Zeitpunkt mit dem aktuellen Shopware-Log. Ein Checkout-Pfad im Stacktrace ist ein Hinweis. Sehen Sie sich die Auslösestelle und vorherige Exceptions an, bevor Sie Zahlungs- oder Versanderweiterungen verändern.

Branchen-Fachwissen SHK, Elektro, Maler
Beispiele aus dem Haus KI-Anwendungen, die wir selbst betreiben
Alle KI-Lösungen → Alles einzeln gebaut, nichts von der Stange.
Alle Software-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Computer & Laptops PC, Mac, Kaufberatung
Mobilgeräte Smartphone, TV, Fotos
Peripherie & Netzwerk Drucker, WLAN, NAS
Alle Hardware-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Privat-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Unternehmens-Leistungen → Alles einzeln gebaut, nichts von der Stange.
linkx© Hub + Module QR-Code für digitale Abläufe
linkx© Module II Pflegeheim, Schule, Wache, Wahl
Alle Submarken → Alles einzeln gebaut, nichts von der Stange.
Alle Artikel im Wissensbereich → Alles einzeln gebaut, nichts von der Stange.