Ein WooCommerce-Problem kann sehr unterschiedlich aussehen: Der Checkout funktioniert nicht, eine Zahlungsmethode fehlt, eine Bestellung bleibt im falschen Status, eine Versandart erscheint nicht oder nach einem Update funktioniert plötzlich etwas anders.
In solchen Situationen ist es meist keine gute Idee, wahllos Einstellungen zu verändern oder mehrere Plugins gleichzeitig zu deaktivieren. Damit lässt sich zwar manchmal zufällig ein Problem beseitigen – die eigentliche Ursache kennst du danach aber noch immer nicht.
Eine saubere Fehlersuche folgt stattdessen einem einfachen Prinzip:
Problem genau beschreiben → reproduzieren → betroffenen Bereich eingrenzen → Logs und Systemstatus prüfen → Ursache kontrolliert testen → erst danach beheben.
Wichtig: Ändere bei der Fehlersuche möglichst immer nur eine Sache gleichzeitig. Teste danach erneut. Nur so kannst du erkennen, welche Änderung tatsächlich einen Unterschied gemacht hat.
Beschreibe zuerst das eigentliche Problem #
„WooCommerce funktioniert nicht“ ist für eine Fehlersuche viel zu ungenau.
Versuche stattdessen festzuhalten, was genau passiert.
Zum Beispiel:
„Wenn ein Kunde mit Lieferadresse Deutschland bestellt, erscheint im Checkout keine Versandart. Mit einer Schweizer Adresse funktioniert der Versand.“
Diese Beschreibung enthält bereits wichtige Hinweise: Der Warenkorb funktioniert, der Checkout wird geladen und das Problem scheint mit Versand und Kundenadresse zusammenzuhängen.
Notiere dir ausserdem:
- Was wolltest du tun?
- Was hast du erwartet?
- Was ist tatsächlich passiert?
- Kannst du das Problem wiederholen?
- Tritt es bei allen Kunden oder nur unter bestimmten Bedingungen auf?
- Seit wann besteht das Problem?
- Wurde unmittelbar davor etwas geändert oder aktualisiert?
Je genauer du das Problem eingrenzen kannst, desto weniger Bereiche musst du später untersuchen.
Versuche das Problem kontrolliert zu reproduzieren #
Ein reproduzierbarer Fehler ist wesentlich einfacher zu untersuchen als ein Problem, das „manchmal irgendwie“ auftritt.
Öffne deinen Shop deshalb möglichst in einem privaten Browserfenster und wiederhole genau den Ablauf, bei dem der Fehler auftritt.
Bei einem Checkout-Problem könnte das beispielsweise bedeuten:
- Ein bestimmtes Produkt in den Warenkorb legen.
- Checkout öffnen.
- Dieselbe Lieferadresse verwenden.
- Dieselbe Versandart oder Zahlungsmethode auswählen.
- Bestellung erneut auslösen beziehungsweise bis zum problematischen Schritt durchführen.
Wenn der Fehler erneut auftritt, hast du einen reproduzierbaren Testfall. Diesen kannst du nach jeder Änderung wiederholen.
Bei einem Live-Shop: Führe keine riskanten Experimente mit echten Kundendaten oder produktiven Zahlungen durch. Für umfangreiche Tests ist eine Staging- beziehungsweise Testumgebung wesentlich besser geeignet.
Wie du einen vollständigen Testablauf durchführst, erklären wir im Artikel WooCommerce-Shop vor dem Start testen: Testbestellung und Checkliste.
Grenze den betroffenen Bereich ein #
WooCommerce besteht aus vielen Bereichen, die miteinander verbunden sind. Trotzdem muss bei einem konkreten Problem nicht der gesamte Shop untersucht werden.
| Problem | Erster Bereich für die Prüfung |
|---|---|
| Produkt kann nicht gekauft werden | Produktstatus, Preis, Lagerbestand und Produkttyp |
| Variante kann nicht gewählt werden | Attribute und Varianten des Produkts |
| Versandart fehlt | Versandzone, Kundenadresse und Versandmethode |
| Zahlungsmethode fehlt | Zahlungseinstellungen und Voraussetzungen des Zahlungsanbieters |
| Zahlung schlägt fehl | Bestellnotizen und Logs der Zahlungs-Erweiterung |
| Bestellung hat unerwarteten Status | Zahlungsart, Bestellnotizen und Statusverlauf |
| Bestell-E-Mail fehlt | E-Mail-Einstellung und transactional-emails-Protokoll |
| Hintergrundaufgabe wird nicht ausgeführt | Geplante Aktionen und Logs |
| Weisse Seite oder schwerwiegender Fehler | Fatal-Error- beziehungsweise PHP-Fehlerprotokoll |
Diese Eingrenzung verhindert, dass du beispielsweise die Versandkonfiguration veränderst, obwohl eigentlich die Zahlung fehlschlägt.
Bestellungen und Bestellnotizen liefern wichtige Hinweise #
Wenn das Problem mit einer konkreten Bestellung zusammenhängt, solltest du diese zuerst unter WooCommerce → Bestellungen öffnen.
Kontrolliere den Bestellstatus, die verwendete Zahlungsmethode, Versandart, Kundendaten und die Bestellnotizen.
WooCommerce und Erweiterungen können in den Bestellnotizen beispielsweise Informationen zu Zahlungen, Statusänderungen oder anderen Verarbeitungsschritten hinterlegen.
Bei einem Zahlungsproblem kann dort beispielsweise erkennbar sein, dass ein Zahlungsversuch fehlgeschlagen ist. In diesem Fall wäre es falsch, die Bestellung einfach manuell auf „In Bearbeitung“ zu setzen und damit das eigentliche Problem zu überdecken.
Wie du Bestellungen richtig liest und verwaltest, erklären wir unter WooCommerce-Bestellungen verwalten: Status, Zahlung und Versand.
Den WooCommerce-Systemstatus prüfen #
Eine der wichtigsten Informationsquellen für die technische Diagnose findest du unter:
WooCommerce → Status
Der Systemstatus zeigt zahlreiche Informationen über deine WordPress- und WooCommerce-Installation. Dazu gehören unter anderem:
- WordPress- und WooCommerce-Version
- Server- und PHP-Umgebung
- PHP-Speicherlimit
- Datenbankinformationen
- aktive und inaktive Plugins
- aktives Theme und Child-Theme
- WooCommerce-Seiten
- WooCommerce-Template-Informationen
- Action Scheduler
Der Bericht hilft dir vor allem dabei, Auffälligkeiten und mögliche Kompatibilitätsprobleme zu erkennen.
Wichtig: Nicht jeder Wert im Systemstatus ist automatisch ein Fehler. Der Bericht liefert technische Informationen und Hinweise. Entscheidend ist immer, ob eine Auffälligkeit tatsächlich zum beobachteten Problem passt.
Den Systemstatus für den Support kopieren #
WooCommerce ermöglicht es, den Systemstatus als Bericht für den Support bereitzustellen.
Unter WooCommerce → Status kannst du den Systembericht aufrufen und für eine Supportanfrage kopieren beziehungsweise herunterladen.
Das ist wesentlich hilfreicher, als lediglich zu schreiben:
„Mein WooCommerce funktioniert nicht.“
Ein Supportmitarbeiter kann anhand des Berichts beispielsweise erkennen, welche WooCommerce-, WordPress- und PHP-Version verwendet wird, welche Erweiterungen aktiv sind und welches Theme eingesetzt wird.
WooCommerce-Logs richtig verwenden #
Die zweite zentrale Informationsquelle findest du unter:
WooCommerce → Status → Protokolle
WooCommerce besitzt ein eigenes Logging-System. WooCommerce selbst und viele Erweiterungen können dort Fehler, Warnungen und technische Ereignisse protokollieren.
Welche Logs vorhanden sind, hängt deshalb von deinem Shop und den installierten Erweiterungen ab.
Suche möglichst nach einem Log, dessen Zeitpunkt und Quelle zu deinem Problem passen.
Wenn beispielsweise um 14:32 Uhr eine Zahlung fehlgeschlagen ist, ist ein passender Logeintrag von diesem Zeitpunkt wesentlich interessanter als ein Fehler von vor drei Wochen.
Ein Logeintrag ist ein Hinweis, nicht automatisch die Ursache. Entscheidend ist, ob Zeitpunkt, betroffene Komponente und Fehlermeldung zu deinem reproduzierbaren Problem passen.
Fatal Errors zuerst ernst nehmen #
WooCommerce protokolliert schwerwiegende PHP-Fehler automatisch in seinen Logs. Solche Einträge findest du unter WooCommerce → Status → Protokolle bei den entsprechenden Fatal-Error-Einträgen.
Ein Fatal Error bedeutet, dass PHP die betreffende Verarbeitung wegen eines schwerwiegenden Fehlers abbrechen musste.
Ein solcher Eintrag enthält normalerweise technische Angaben wie:
- Zeitpunkt des Fehlers
- Fehlermeldung
- betroffene PHP-Datei
- Zeilennummer
- weitere technische Informationen zum Ablauf
Für einen Laien ist nicht jede Zeile verständlich. Häufig lässt sich aber bereits am Dateipfad erkennen, ob der Fehler beispielsweise aus WooCommerce Core, einem bestimmten Plugin oder dem Theme stammt.
Nicht direkt PHP-Dateien bearbeiten: Wenn ein Fehler auf eine Plugin-Datei verweist, solltest du nicht einfach den Programmcode dieser Datei verändern. Bei einem Update würden solche Änderungen überschrieben, und eine falsche Änderung kann weitere Fehler verursachen.
Logs von Zahlungs- und anderen Erweiterungen #
Viele WooCommerce-Erweiterungen besitzen zusätzliche Diagnoseprotokolle. Besonders bei Zahlungsanbietern sind diese häufig sehr hilfreich.
Solche Logs müssen je nach Erweiterung zuerst in deren Einstellungen aktiviert werden.
Wenn beispielsweise eine Kreditkartenzahlung fehlschlägt, solltest du deshalb nicht nur den WooCommerce-Bestellstatus ansehen. Prüfe auch die Bestellnotizen und – sofern vorhanden – das Protokoll der tatsächlich verwendeten Zahlungs-Erweiterung.
Die genaue Bezeichnung und der Inhalt solcher Logs unterscheiden sich von Anbieter zu Anbieter.
Mehr zum Zusammenspiel zwischen Bestellung und Zahlung findest du unter Zahlungsmethoden in WooCommerce einrichten und verwalten.
Geplante Aktionen kontrollieren #
WooCommerce und zahlreiche Erweiterungen führen bestimmte Aufgaben nicht unmittelbar während eines Seitenaufrufs aus, sondern verarbeiten sie im Hintergrund.
Dafür wird unter anderem der Action Scheduler verwendet.
Die Übersicht findest du unter:
WooCommerce → Status → Geplante Aktionen
Dort kannst du sehen, ob Aufgaben beispielsweise:
- ausstehend,
- abgeschlossen,
- fehlgeschlagen
- oder abgebrochen
sind.
Einzelne fehlgeschlagene Aktionen bedeuten nicht automatisch, dass dein gesamter Shop ein Problem hat. Wenn sich jedoch viele Aufgaben stauen oder dieselbe Aktion immer wieder fehlschlägt, sollte die Ursache untersucht werden.
Fatal Errors können beispielsweise dazu führen, dass eine Hintergrundaufgabe nicht erfolgreich abgeschlossen wird.
Prüfe, ob das Problem nach einer Änderung begonnen hat #
Der Zeitpunkt eines Fehlers ist oft ein sehr guter Hinweis.
Frage dich:
Was wurde unmittelbar davor verändert?
Das kann beispielsweise ein Update von WooCommerce, WordPress, einem Plugin oder Theme gewesen sein. Vielleicht wurde aber auch eine neue Erweiterung installiert, eine Einstellung geändert oder eigener Programmcode ergänzt.
Wenn ein Shop monatelang funktioniert und unmittelbar nach einer bestimmten Änderung ein reproduzierbares Problem auftritt, gehört diese Änderung zu den ersten Dingen, die genauer untersucht werden sollten.
Das beweist noch nicht, dass sie die Ursache ist. Sie liefert aber einen konkreten Ausgangspunkt.
Updates gehören zur Diagnose – aber kontrolliert #
Veraltete Versionen von WordPress, WooCommerce, Plugins oder Themes können Fehler und Kompatibilitätsprobleme verursachen. Aktuelle Versionen enthalten ausserdem Fehlerkorrekturen und Sicherheitsupdates.
Das bedeutet jedoch nicht, dass du mitten in einer laufenden Fehlersuche wahllos alles aktualisieren solltest.
Bei einem produktiven Shop ist ein kontrolliertes Vorgehen sinnvoll:
- Aktuellen Zustand und Problem dokumentieren.
- Sicherstellen, dass eine aktuelle Sicherung vorhanden ist.
- Wenn möglich in einer Staging-Umgebung testen.
- Updates kontrolliert durchführen.
- Den zuvor dokumentierten Fehler erneut testen.
Nur so erkennst du, ob das Update das Problem tatsächlich behoben hat.
Plugin-Konflikte systematisch testen #
WooCommerce arbeitet häufig mit vielen Erweiterungen gleichzeitig. Ein Fehler kann deshalb durch einen Konflikt zwischen zwei Plugins entstehen.
Für einen aussagekräftigen Konflikttest wird die Umgebung schrittweise reduziert.
In einer sicheren Testumgebung kannst du beispielsweise alle nicht benötigten Plugins deaktivieren und nur WooCommerce sowie die für den konkreten Test zwingend erforderliche Erweiterung aktiv lassen.
Teste danach erneut.
Ist der Fehler verschwunden, aktivierst du die übrigen Plugins kontrolliert wieder und testest nach jeder Änderung erneut. Sobald der Fehler zurückkehrt, hast du einen starken Hinweis auf die beteiligte Komponente.
Nicht blind im Live-Shop durchführen: Das Deaktivieren von Zahlungs-, Versand-, Sicherheits-, Cache- oder anderen wichtigen Plugins kann den laufenden Shopbetrieb verändern. Umfangreiche Konflikttests gehören deshalb möglichst in eine Staging-Umgebung.
Auch das Theme kann einen Konflikt verursachen #
Nicht nur Plugins können WooCommerce beeinflussen. Auch das aktive WordPress-Theme enthält Programmcode und kann beispielsweise Produktseiten, Warenkorb oder Checkout verändern.
WooCommerce empfiehlt deshalb bei einem vollständigen Konflikttest auch die vorübergehende Verwendung eines bekannten kompatiblen Standard-Testthemes wie Storefront.
Verschwindet das Problem mit dem Testtheme, während Plugins und sonstige Bedingungen unverändert bleiben, ist das ein deutlicher Hinweis darauf, dass das bisherige Theme oder dessen Anpassungen am Problem beteiligt sind.
Auch dieser Test sollte bei einem produktiven Shop möglichst nicht für normale Besucher sichtbar durchgeführt werden.
Health Check kann Konflikttests erleichtern #
WordPress stellt mit dem Plugin Health Check & Troubleshooting einen speziellen Troubleshooting-Modus zur Verfügung.
Dieser Modus ermöglicht es einem angemeldeten Administrator, Plugins und Theme für seine eigene Sitzung testweise zu verändern, ohne dass normale Besucher dieselbe Testkonfiguration sehen.
Das kann bei einem Konflikttest hilfreich sein.
Trotzdem vorsichtig bleiben: Ein Troubleshooting-Modus ersetzt keine vollständige Staging-Umgebung. Besonders bei Zahlungen, externen Schnittstellen, Hintergrundprozessen und echten Bestellungen ist eine separate Testumgebung die sauberere Lösung.
Cache kann die Fehlersuche verfälschen #
Caching beschleunigt Websites, kann bei der Fehlersuche aber dafür sorgen, dass du nicht sofort die aktuelle Version einer Seite siehst.
Nach Änderungen kann deshalb je nach eingesetztem Cache-System ein gezieltes Leeren des betreffenden Caches notwendig sein.
Auch der Browser selbst kann Dateien zwischenspeichern. Ein privates Browserfenster kann deshalb bei Frontend-Tests hilfreich sein.
Deaktiviere oder lösche aber nicht auf Verdacht sämtliche Performance-Einstellungen. Prüfe zuerst, ob Caching überhaupt mit dem konkreten Problem zusammenhängen kann.
Frontend-Fehler und Serverfehler unterscheiden #
Nicht jedes WooCommerce-Problem entsteht auf dem Server.
Wenn beispielsweise ein Button nicht reagiert, ein Checkout-Bereich nicht aktualisiert wird oder Elemente plötzlich verschwinden, kann auch JavaScript oder die Darstellung im Browser beteiligt sein.
Ein PHP Fatal Error ist dagegen ein serverseitiger Fehler.
Für eine erste Einordnung hilft deshalb die Frage:
Wird die Seite vollständig geladen und funktioniert nur eine bestimmte Bedienung nicht – oder bricht die Verarbeitung grundsätzlich mit einer Fehlermeldung ab?
Für tiefergehende Browserdiagnosen können die Entwicklerwerkzeuge des Browsers hilfreich sein. Diese sind jedoch eher für erfahrene Anwender oder den technischen Support gedacht.
Nicht jede Fehlermeldung stammt von WooCommerce #
Ein WooCommerce-Shop besteht nicht nur aus WooCommerce.
WordPress Core, Theme, Plugins, Zahlungsanbieter, externe Schnittstellen, PHP, Datenbank, Webserver und andere Dienste arbeiten zusammen.
Eine Fehlermeldung im Checkout kann deshalb beispielsweise von einer Zahlungs-Erweiterung stammen, obwohl sie auf einer WooCommerce-Seite angezeigt wird.
Schau bei einer Fehlermeldung deshalb möglichst genau hin:
Welche Komponente wird genannt? Taucht ein Pluginname auf? Gibt es einen Fehlercode? Findest du zum gleichen Zeitpunkt einen passenden Logeintrag?
Diese Informationen sind meist wertvoller als die Seite, auf der der Fehler sichtbar geworden ist.
Wann du nicht selbst weiterprobieren solltest #
Eine systematische Diagnose bedeutet nicht, dass du jeden technischen Fehler selbst reparieren musst.
Spätestens bei schwerwiegenden PHP-Fehlern, Datenbankproblemen, wiederkehrenden Serverfehlern oder Problemen mit produktiven Zahlungen solltest du nicht auf Verdacht Änderungen an Programmcode oder Datenbank durchführen.
Auch Fehlermeldungen mit Zugangsdaten, API-Schlüsseln oder anderen sensiblen Informationen solltest du nicht öffentlich veröffentlichen.
Deine Aufgabe kann zunächst darin bestehen, das Problem sauber einzugrenzen und die relevanten Informationen für den zuständigen Support zusammenzustellen.
Was eine gute Supportanfrage enthalten sollte #
Je besser eine technische Anfrage dokumentiert ist, desto schneller lässt sich ein Problem normalerweise untersuchen.
Eine hilfreiche Supportanfrage enthält:
- eine genaue Beschreibung des Problems,
- das erwartete Verhalten,
- das tatsächlich beobachtete Verhalten,
- die genauen Schritte, mit denen sich der Fehler reproduzieren lässt,
- Zeitpunkt beziehungsweise Zeitraum des Fehlers,
- relevante Fehlermeldungen,
- passende Screenshots,
- relevante Logeinträge,
- den WooCommerce-Systemstatus,
- Informationen über bereits durchgeführte Tests.
Statt:
„Checkout geht nicht.“
ist beispielsweise folgende Information wesentlich hilfreicher:
„Seit dem Update von Plugin X erscheint bei einer Bestellung mit Produkt Y nach Auswahl der Zahlungsmethode Z eine Fehlermeldung. Der Fehler lässt sich in einem privaten Browserfenster wiederholen. Im WooCommerce-Log erscheint zum gleichen Zeitpunkt folgende Meldung …“
Damit weiss der Support bereits, was getestet wurde und wo die Untersuchung beginnen kann.
Eine einfache Diagnose-Reihenfolge für den Alltag #
Du musst dir für die tägliche Arbeit nicht jede technische Möglichkeit merken. Bei den meisten WooCommerce-Problemen hilft folgende Reihenfolge:
| Schritt | Was du prüfst |
|---|---|
| Problem | Was genau funktioniert nicht? |
| Reproduktion | Kann der Fehler zuverlässig wiederholt werden? |
| Bereich | Produkt, Checkout, Versand, Zahlung, Bestellung, E-Mail oder Hintergrundprozess? |
| Bestellung | Falls vorhanden: Status, Notizen, Zahlung und Versand prüfen. |
| Systemstatus | Gibt es auffällige Versionen, Serverwerte, Plugins, Theme- oder Template-Hinweise? |
| Logs | Gibt es zum Zeitpunkt des Fehlers einen passenden Eintrag? |
| Änderungen | Was wurde unmittelbar vor dem ersten Auftreten geändert? |
| Konflikttest | Lässt sich eine beteiligte Erweiterung oder das Theme kontrolliert identifizieren? |
| Lösung | Erst jetzt die festgestellte Ursache gezielt beheben. |
| Kontrolle | Den ursprünglichen Testfall nochmals vollständig durchführen. |
Mit dieser Methode wird aus einem unspezifischen „WooCommerce funktioniert nicht“ Schritt für Schritt ein konkretes und untersuchbares Problem.
Zusammenfassung #
Eine gute WooCommerce-Fehlersuche beginnt nicht mit zufälligen Änderungen, sondern mit einer möglichst genauen Beschreibung und einem reproduzierbaren Testfall.
Grenze danach den betroffenen Bereich ein. Bei Bestellproblemen liefern Bestellstatus und Bestellnotizen häufig erste Hinweise. Unter WooCommerce → Status findest du wichtige Informationen zur technischen Umgebung. Unter WooCommerce → Status → Protokolle kannst du nach Fehlern suchen, die zeitlich und inhaltlich zum Problem passen.
Bei Hintergrundprozessen solltest du zusätzlich die geplanten Aktionen kontrollieren. Wenn ein Plugin- oder Theme-Konflikt vermutet wird, sollte dieser kontrolliert und möglichst in einer Staging-Umgebung getestet werden.
Ändere immer nur eine Sache gleichzeitig und wiederhole danach denselben Test. So kannst du feststellen, ob eine Änderung tatsächlich die Ursache beeinflusst hat.
Und wenn das Problem technisches Fachwissen erfordert, ist eine saubere Diagnose trotzdem wertvoll: Mit Systemstatus, Logs, Fehlermeldung und reproduzierbaren Schritten kann der zuständige Support wesentlich gezielter nach der Ursache suchen.
