Un problème WooCommerce peut revêtir des formes très diverses : le paiement ne fonctionne pas, une méthode de paiement est manquante, une commande reste dans le mauvais statut, un mode de livraison n'apparaît pas ou, après une mise à jour, quelque chose fonctionne soudainement différemment.
Dans de telles situations, il n'est généralement pas judicieux de modifier des paramètres au hasard ou de désactiver plusieurs extensions en même temps. Cela permet parfois de résoudre un problème par pur hasard, mais vous ne connaissez toujours pas la cause réelle du problème.
Un dépannage propre suit plutôt un principe simple :
Décrire précisément le problème → le reproduire → délimiter la zone touchée → vérifier les journaux et l'état du système → tester la cause de manière contrôlée → corriger seulement après.
Important : Lors du dépannage, ne modifiez si possible qu'une seule chose à la fois. Testez à nouveau ensuite. C'est la seule façon de savoir quel changement a réellement fait la différence.
Décris d'abord le problème réel #
„ WooCommerce ne fonctionne pas “ est beaucoup trop imprécis pour un dépannage.
Essayez plutôt de noter ce qui se passe exactement.
Par exemple :
„Lorsqu'un client commande avec une adresse de livraison en Allemagne, aucun mode de livraison n'apparaît lors du paiement. Avec une adresse suisse, l'expédition fonctionne.“
Cette description contient déjà des indices importants : le panier fonctionne, le tunnel de commande se charge et le problème semble être lié à l'expédition et à l'adresse du client.
Note également :
- Qu'est-ce que tu voulais faire ?
- Qu'attendais-tu ?
- Qu'est-ce qui s'est réellement passé ?
- Pouvez-vous répéter le problème ?
- Se produit-il chez tous les clients ou seulement dans certaines conditions ?
- Depuis quand ce problème existe-t-il ?
- Y a-t-il eu des modifications ou des mises à jour juste avant ?
Plus tu réussis à cerner le problème, moins tu auras de zones à explorer par la suite.
Essayez de reproduire le problème de manière contrôlée. #
Un bug reproductible est beaucoup plus facile à étudier qu'un problème qui survient „ parfois d'une manière ou d'une autre “.
Ouvrez donc votre boutique dans une fenêtre de navigation privée si possible et répétez exactement la procédure lors de laquelle l'erreur se produit.
En cas de problème lors du paiement, cela pourrait par exemple signifier :
- Ajouter un produit spécifique au panier.
- Passer à la caisse.
- Utiliser la même adresse de livraison.
- Sélectionner le même mode de livraison ou moyen de paiement.
- Passer à nouveau la commande ou effectuer les étapes jusqu'à celle qui pose problème.
Si l'erreur se reproduit, tu as un cas de test reproductible. Tu peux le répéter après chaque modification.
Lors d'un live-shopping : N'effectuez pas d'expériences risquées avec de vraies données clients ou des paiements de production. Un environnement de staging ou de test est beaucoup plus adapté pour des tests approfondis.
Nous expliquons comment réaliser une procédure de test complète dans l'article Tester sa boutique WooCommerce avant le lancement : commande test et liste de contrôle.
Délimitez la zone concernée #
WooCommerce se compose de nombreux éléments interconnectés. Pourtant, en cas de problème spécifique, il n'est pas nécessaire d'examiner l'ensemble de la boutique.
| Problème | Première section pour l'examen |
|---|---|
| Ce produit ne peut pas être acheté | Statut du produit, prix, stock et type de produit |
| La variante ne peut pas être choisie | Attributs et variantes du produit |
| Mode d'expédition manquant | Zone de livraison, adresse du client et mode de livraison |
| Mode de paiement manquant | Paramètres de paiement et exigences du prestataire de services de paiement |
| Le paiement a échoué | Notes de commande et journaux de l'extension de paiement |
| La commande a un statut inattendu | Mode de paiement, notes de commande et historique des statuts |
| L'e-mail de confirmation de commande est manquant | Paramètre de messagerie et journal des e-mails transactionnels |
| La tâche de fond ne s'exécute pas | Actions planifiées et journaux |
| Page blanche ou erreur fatale | Journal des erreurs fatales ou des erreurs PHP |
Cette restriction empêche, par exemple, de modifier la configuration des expéditions alors qu'en réalité le paiement échoue.
Les commandes et les notes de commande fournissent des indications importantes. #
Si le problème est lié à une commande spécifique, tu devrais d'abord la trouver sous WooCommerce → Commandes ouvrir.
Vérifiez le statut de la commande, le mode de paiement utilisé, le mode de livraison, les données client et les notes de commande.
WooCommerce et ses extensions peuvent, par exemple, consigner dans les notes de commande des informations concernant les paiements, les changements de statut ou d'autres étapes de traitement.
En cas de problème de paiement, il peut être visible par exemple qu'une tentative de paiement a échoué. Dans ce cas, il serait erroné de basculer simplement la commande manuellement sur „ En cours de traitement “ et de masquer ainsi le véritable problème.
Nous expliquons comment lire et gérer correctement les commandes sur Gérer les commandes WooCommerce : statut, paiement et expédition.
Vérifier l'état du système WooCommerce #
L'une des sources d'information les plus importantes pour le diagnostic technique se trouve sous :
WooCommerce → État
L'état du système affiche de nombreuses informations concernant votre installation WordPress et WooCommerce. Celles-ci incluent, entre autres :
- Version de WordPress et de WooCommerce
- Environnement de serveur et PHP
- Limite de mémoire PHP
- Informations sur la base de données
- plugins actifs et inactifs
- thème actif et thème enfant
- Pages WooCommerce
- Informations sur le modèle WooCommerce
- Action Scheduler
Le rapport vous aide surtout à identifier les anomalies et les problèmes de compatibilité potentiels.
Important : Toutes les valeurs de l'état du système ne constituent pas automatiquement une erreur. Le rapport fournit des informations techniques et des indications. Il est toujours crucial de déterminer si une anomalie correspond effectivement au problème observé.
Copier l'état du système pour le support #
WooCommerce permet de fournir l'état du système sous forme de rapport pour le support.
Sous WooCommerce → État peux-tu appeler le rapport système et le copier ou le télécharger pour une demande de support.
C'est nettement plus utile que de se contenter d'écrire :
„Mon WooCommerce ne fonctionne pas.“
Un agent du support technique peut ainsi déterminer, à l'aide du rapport, quelles versions de WooCommerce, de WordPress et de PHP sont utilisées, quelles extensions sont actives et quel thème est déployé.
Utiliser correctement les journaux WooCommerce #
Tu trouveras la deuxième source d'information principale sur :
WooCommerce → État → Journaux
WooCommerce possède son propre système de journalisation. WooCommerce lui-même et de nombreuses extensions peuvent y enregistrer des erreurs, des avertissements et des événements techniques.
Les journaux disponibles dépendent donc de votre boutique et des extensions installées.
Recherchez si possible un journal dont l'heure et la source correspondent à votre problème.
Si, par exemple, un paiement a échoué à 14h32, une entrée de journal correspondante datant de ce moment-là est bien plus intéressante qu'une erreur survenue il y a trois semaines.
Une entrée de journal est un indice, pas automatiquement la cause. Ce qui est déterminant, c'est de savoir si le moment, la composante concernée et le message d'erreur correspondent à ton problème reproductible.
Prendre d'abord les erreurs fatales au sérieux #
WooCommerce enregistre automatiquement les erreurs PHP graves dans ses journaux. Vous trouverez de telles entrées sous WooCommerce → État → Journaux dans les entrées d'erreur fatale correspondantes.
Une erreur fatale signifie que PHP a dû interrompre le traitement concerné en raison d'une erreur grave.
Une telle entrée contient généralement des informations techniques telles que :
- Moment de l'erreur
- Message d'erreur
- fichier PHP concerné
- Numéro de ligne
- informations techniques supplémentaires sur le déroulement
Pour un novice, chaque ligne n'est pas forcément compréhensible. Souvent, on peut toutefois déjà deviner d'après le chemin du fichier si l'erreur provient par exemple de WooCommerce Core, d'une extension spécifique ou du thème.
Ne pas modifier directement les fichiers PHP : Si une erreur fait référence à un fichier de plugin, vous ne devez pas simplement modifier le code source de ce fichier. Lors d'une mise à jour, de telles modifications seraient écrasées, et une modification incorrecte peut provoquer d'autres erreurs.
Journaux des paiements et autres extensions #
De nombreuses extensions WooCommerce disposent de journaux de diagnostic supplémentaires. Ceux-ci sont souvent très utiles, en particulier pour les prestataires de services de paiement.
Ce type de journaux doit d'abord être activé dans les paramètres de l'extension concernée.
Par conséquent, si par exemple un paiement par carte de crédit échoue, vous ne devez pas seulement regarder le statut de la commande WooCommerce. Vérifiez également les notes de commande et, le cas échéant, le journal de l'extension de paiement effectivement utilisée.
La désignation exacte et le contenu de tels journaux diffèrent d'un fournisseur à l'autre.
Pour en savoir plus sur l'interaction entre la commande et le paiement, consultez Configurer et gérer les méthodes de paiement dans WooCommerce.
Vérifier les actions planifiées #
WooCommerce et de nombreuses extensions n'exécutent pas certaines tâches immédiatement lors du chargement d'une page, mais les traitent en arrière-plan.
À cette fin, on utilise entre autres le Action Scheduler utilisé.
Vous trouverez un aperçu sur :
WooCommerce → État → Actions planifiées
Là, tu peux voir si les tâches, par exemple :
- en attente,
- terminé,
- échec
- ou annulé
sont.
Des actions individuelles qui échouent ne signifient pas automatiquement que l'ensemble de votre boutique a un problème. Cependant, si de nombreuses tâches s'accumulent ou si la même action échoue encore et encore, la cause doit être examinée.
Les erreurs fatales peuvent, par exemple, empêcher l'achèvement réussi d'une tâche d'arrière-plan.
Vérifiez si le problème a commencé après une modification #
Le moment d'une erreur est souvent un très bon indice.
Demande-toi :
Qu'est-ce qui a été modifié immédiatement avant ?
Cela aurait pu être, par exemple, une mise à jour de WooCommerce, de WordPress, d'une extension ou d'un thème. Mais il est également possible qu'un nouveau module ait été installé, qu'un paramètre ait été modifié ou que du code personnalisé ait été ajouté.
Si une boutique fonctionne pendant des mois et qu'un problème reproductible survient immédiatement après une modification spécifique, cette modification fait partie des premières choses à examiner de plus près.
Cela ne prouve pas encore qu'elle en est la cause. Mais cela fournit un point de départ concret.
Les mises font partie du diagnostic – mais de manière contrôlée #
Des versions obsolètes de WordPress, WooCommerce, de plugins ou de thèmes peuvent entraîner des erreurs et des problèmes de compatibilité. De plus, les versions récentes contiennent des corrections de bugs et des mises à jour de sécurité.
Cependant, cela ne signifie pas que tu devrais tout mettre à jour au hasard au milieu d'un dépannage en cours.
Pour une boutique en production, une approche contrôlée est judicieuse :
- Documenter l'état actuel et le problème.
- S'assurer qu'une sauvegarde récente est disponible.
- Tester dans un environnement de staging si possible.
- Effectuer les mises à jour de manière contrôlée.
- Retester l'erreur documentée précédemment.
C'est le seul moyen de savoir si la mise a jour a réellement résolu le problème.
Tester systématiquement les conflits de plugins #
WooCommerce fonctionne souvent avec de nombreuses extensions en même temps. Une erreur peut donc provenir d'un conflit entre deux plugins.
Pour un test de conflit significatif, l'environnement est réduit progressivement.
Dans un environnement de test sécurisé, vous pouvez par exemple désactiver tous les plugins inutilisés et ne laisser actif que WooCommerce ainsi que l'extension strictement nécessaire pour le test en question.
Testez à nouveau ensuite.
Une fois l'erreur disparue, vous réactivez les autres extensions de manière contrôlée et testez à nouveau après chaque modification. Dès que l'erreur réapparaît, vous avez un indice fort sur le composant impliqué.
Ne pas effectuer à l'aveugle dans la boutique en direct : La désactivation de plugins de paiement, d'expédition, de sécurité, de cache ou d'autres plugins importants peut altérer le fonctionnement de la boutique en cours. Par conséquent, les tests de conflits approfondis doivent si possible être effectués dans un environnement de staging.
Le thème peut aussi causer un conflit #
Ce ne sont pas seulement les plugins qui peuvent influencer WooCommerce. Le thème WordPress actif contient également du code de programmation et peut, par exemple, modifier les pages de produits, le panier ou la caisse.
WooCommerce recommande par conséquent, lors d'un test de conflit complet, l'utilisation temporaire d'un thème de test standard compatible connu tel que Vitrine.
Si le problème disparaît avec le thème de test, tandis que les extensions et les autres conditions restent inchangées, c'est une indication claire que le thème précédent ou ses personnalisations sont impliqués dans le problème.
Cet test ne devrait également pas, si possible, être effectué de manière visible pour les visiteurs normaux sur une boutique en production.
Le bilan de santé peut faciliter les tests de conflit. #
WordPress propose avec le 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.
Au lieu de :
„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 |
|---|---|
| Problème | Was genau funktioniert nicht? |
| Reproduktion | Kann der Fehler zuverlässig wiederholt werden? |
| Domaine | Produkt, Checkout, Versand, Zahlung, Bestellung, E-Mail oder Hintergrundprozess? |
| Commande | Falls vorhanden: Status, Notizen, Zahlung und Versand prüfen. |
| État du système | Gibt es auffällige Versionen, Serverwerte, Plugins, Theme- oder Template-Hinweise? |
| Journaux | 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. |
| Contrôle | 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.
Résumé #
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 → État findest du wichtige Informationen zur technischen Umgebung. Unter WooCommerce → État → Journaux 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.
