Dépannage WooCommerce
Votre boutique fait des siennes ? Pas de panique. La plupart des problèmes WooCommerce ont des causes identifiables et des solutions éprouvées. Ce guide regroupe les situations les plus fréquentes et vous accompagne pas à pas vers leur résolution.
Dans ce guide :
Avant toute intervention - Créez une sauvegarde complète de votre site. Une manipulation maladroite peut aggraver le problème. Mieux vaut pouvoir revenir en arrière.
Problèmes d'affichage
Les soucis visuels sont parmi les plus fréquents et souvent les plus simples à résoudre.
Les prix ne s'affichent pas correctement
Symptômes : Prix à 0€, devise manquante, format incorrect (1000 au lieu de 1 000,00 €).
Causes possibles : - Paramètres de devise mal configurés - Conflit avec un plugin de cache - Thème incompatible
Solutions : 1. Vérifiez WooCommerce > Réglages > Général : devise, position du symbole, séparateurs 2. Videz le cache (WP Rocket, W3 Total Cache, ou cache hébergeur) 3. Testez avec le thème Storefront pour isoler un problème de thème
Les images produits ne s'affichent pas
Symptômes : Images cassées, placeholder gris, miniatures floues.
Solutions :
1. Régénérez les miniatures : WooCommerce > État > Outils > Régénérer les miniatures
2. Vérifiez les permissions du dossier /wp-content/uploads/ (755 pour les dossiers, 644 pour les fichiers)
3. Augmentez la limite mémoire PHP si les images sont volumineuses
Le panier affiche des informations incorrectes
Symptômes : Quantités erronées, produits fantômes, total qui ne correspond pas.
Solutions : 1. Videz le cache du site ET le cache navigateur 2. Excluez les pages panier et checkout du cache dans votre plugin de cache 3. Vérifiez qu'aucun plugin de personnalisation du panier ne cause de conflit
La page produit est cassée
Symptômes : Layout déformé, éléments manquants, galerie qui ne fonctionne pas.
Solutions : 1. Désactivez temporairement les plugins un par un pour identifier un conflit 2. Vérifiez que votre thème est à jour 3. Inspectez la console JavaScript (F12) pour repérer les erreurs JS
Problèmes de paiement 🔺
C'est le nerf de la guerre. Un checkout qui dysfonctionne, ce sont des ventes perdues.
Le paiement est refusé systématiquement
Symptômes : Tous les paiements échouent, même avec des cartes valides.
Causes possibles : - Mode sandbox/test encore actif - Clés API incorrectes ou expirées - Certificat SSL invalide
Solutions : 1. Vérifiez que vous êtes en mode "Live" et non "Test" dans les réglages de la passerelle 2. Régénérez vos clés API depuis le dashboard Stripe/PayPal 3. Vérifiez votre certificat SSL : le cadenas doit être vert, sans erreur
Le bouton "Payer" ne fait rien
Symptômes : Clic sur le bouton sans réaction, page qui se recharge sans validation.
Solutions : 1. Ouvrez la console JavaScript (F12 > Console) et cherchez les erreurs en rouge 2. Désactivez les plugins de sécurité qui peuvent bloquer les requêtes 3. Vérifiez que jQuery est bien chargé (certains thèmes le désactivent par erreur)
Erreur "Désolé, ce coupon n'existe pas"
Symptômes : Un coupon valide est rejeté.
Solutions : 1. Vérifiez la date d'expiration du coupon 2. Vérifiez les restrictions d'usage (montant minimum, produits exclus) 3. Vérifiez que le coupon n'a pas atteint sa limite d'utilisation
Le client est débité mais la commande n'apparaît pas
Symptômes : Paiement encaissé côté passerelle, mais commande absente ou en "En attente".
Causes : Le webhook de confirmation n'a pas fonctionné.
Solutions : 1. Vérifiez les webhooks dans le dashboard Stripe/PayPal 2. Vérifiez que votre hébergeur n'a pas bloqué les requêtes entrantes 3. Consultez les logs WooCommerce : WooCommerce > État > Logs
Problèmes d'emails 🔺
Les emails transactionnels sont essentiels. Un client qui ne reçoit pas sa confirmation s'inquiète.
Les emails ne partent pas du tout
Symptômes : Aucun email reçu (confirmation, nouveau compte, réinitialisation mot de passe).
Causes possibles : - Fonction mail PHP désactivée par l'hébergeur - Emails envoyés mais en spam - Plugin d'email mal configuré
Solutions : 1. Testez l'envoi : WooCommerce > État > Outils > Envoyer un email de test 2. Installez un plugin SMTP comme WP Mail SMTP et configurez un service externe (SendGrid, Mailgun, Gmail) 3. Vérifiez les dossiers spam de vos clients
Les emails arrivent en spam
Symptômes : Emails envoyés mais classés en indésirables.
Solutions : 1. Configurez les enregistrements SPF, DKIM et DMARC sur votre domaine 2. Utilisez un service d'envoi professionnel (SendGrid, Mailgun) 3. Évitez les mots déclencheurs de spam dans l'objet ("GRATUIT", "URGENT", majuscules excessives)
Les emails ont un design cassé
Symptômes : Mise en page déformée, images manquantes, texte brut au lieu de HTML.
Solutions : 1. Réinitialisez les templates : WooCommerce > Réglages > Emails > [Email] > Réinitialiser le template 2. Vérifiez que votre thème n'écrase pas les templates email de manière incorrecte 3. Testez avec différents clients mail (Gmail, Outlook, Apple Mail)
Problèmes de performance 🔺
Une boutique lente perd des clients. Chaque seconde compte.
Le site met plus de 5 secondes à charger
Diagnostic : Testez sur GTmetrix ou PageSpeed Insights pour identifier les goulots d'étranglement.
Solutions courantes : 1. Installez un plugin de cache (WP Rocket recommandé) 2. Optimisez les images avec ShortPixel ou Imagify 3. Utilisez un CDN (Cloudflare gratuit) 4. Passez à un hébergeur plus performant si vous êtes sur du mutualisé bas de gamme
Le tableau de bord admin est très lent
Symptômes : Pages admin qui mettent 10+ secondes à charger.
Causes possibles : - Trop de produits/commandes affichés par page - Plugin d'analytics qui charge des données en temps réel - Base de données non optimisée
Solutions : 1. Réduisez le nombre d'éléments par page dans les listes (20 au lieu de 100) 2. Désactivez les widgets dashboard inutiles 3. Nettoyez la base de données avec WP-Optimize
Le checkout est lent
Symptômes : La page panier/checkout met plusieurs secondes à se charger ou à valider.
Solutions : 1. Excluez les pages panier/checkout du cache (elles doivent rester dynamiques) 2. Réduisez le nombre de passerelles de paiement actives 3. Désactivez les calculs de livraison en temps réel si non indispensables
Problèmes de stock 🔺
La gestion des stocks peut créer des situations frustrantes si elle n'est pas correctement configurée.
Le stock ne se décrémente pas après une vente
Causes possibles : - Gestion des stocks désactivée - Statut de commande qui ne déclenche pas la décrémentation
Solutions : 1. Vérifiez WooCommerce > Réglages > Produits > Inventaire : la gestion des stocks doit être activée 2. Vérifiez que le produit individuel a la gestion de stock activée 3. Le stock se décrémente quand la commande passe en "En cours" ou "Terminée", pas avant
Un produit s'affiche "En rupture" alors qu'il reste du stock
Solutions : 1. Vérifiez le stock dans la fiche produit 2. Pour les produits variables, vérifiez le stock de chaque variation 3. Videz le cache transients : WooCommerce > État > Outils > Effacer les transients
Survente : plus de commandes que de stock disponible
Causes : Deux clients ont commandé simultanément avant que le stock ne soit mis à jour.
Prévention : 1. Activez le "seuil de stock faible" pour être alerté avant rupture 2. Pour les produits très demandés, gardez une marge de sécurité 3. Considérez un plugin de gestion de stock avancé pour les grosses boutiques
Conflits de plugins 🔺
La majorité des problèmes WooCommerce proviennent de conflits entre extensions.
Comment identifier un conflit
- Désactivez TOUS les plugins sauf WooCommerce
- Le problème disparaît ? C'est un conflit de plugin
- Réactivez les plugins un par un, en testant après chaque réactivation
- Le problème réapparaît avec le plugin X ? Vous avez trouvé le coupable
Conflits courants connus
WP Rocket + WooCommerce : Excluez les pages dynamiques du cache (panier, checkout, mon compte).
Yoast SEO + certains thèmes : Désactivez les breadcrumbs Yoast si le thème a les siens.
Elementor + plugins de slider : Conflits JavaScript fréquents, chargez les scripts dans le bon ordre.
Plugins de sécurité + passerelles de paiement : Les pare-feu peuvent bloquer les webhooks de Stripe/PayPal.
Que faire quand un plugin essentiel cause un conflit
- Contactez le support du plugin (les plugins payants ont généralement un bon support)
- Cherchez une alternative compatible
- En dernier recours, faites appel à un développeur pour résoudre le conflit
Écran blanc de la mort 🔺
L'écran blanc (WSOD - White Screen of Death) est terrifiant mais rarement fatal.
Causes principales
- Erreur PHP fatale (souvent après une mise à jour)
- Limite mémoire dépassée
- Plugin ou thème corrompu
Solutions pas à pas
1. Activer le mode debug
Accédez à votre fichier wp-config.php via FTP et ajoutez :
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
Rechargez la page. L'erreur exacte apparaîtra ou sera enregistrée dans /wp-content/debug.log.
2. Augmenter la limite mémoire
Dans wp-config.php, ajoutez :
define('WP_MEMORY_LIMIT', '256M');
3. Désactiver les plugins via FTP
Si vous n'avez plus accès au dashboard :
1. Connectez-vous en FTP
2. Renommez le dossier /wp-content/plugins/ en /wp-content/plugins_disabled/
3. Le site devrait revenir (sans fonctionnalités des plugins)
4. Renommez le dossier en /wp-content/plugins/
5. Renommez les plugins un par un pour identifier le fautif
4. Changer de thème via FTP
Renommez le dossier de votre thème dans /wp-content/themes/. WordPress basculera sur un thème par défaut.
Erreurs 500 et autres 🔺
Les erreurs HTTP indiquent des problèmes serveur ou de configuration.
Erreur 500 - Internal Server Error
Causes possibles : - Fichier .htaccess corrompu - Limite mémoire PHP dépassée - Permissions de fichiers incorrectes
Solutions :
1. Renommez .htaccess en .htaccess_old via FTP, puis régénérez-le via Réglages > Permaliens > Enregistrer
2. Augmentez la limite mémoire PHP (via cPanel ou wp-config.php)
3. Vérifiez les permissions : 755 pour les dossiers, 644 pour les fichiers
Erreur 403 - Forbidden
Causes : Permissions incorrectes ou règles de sécurité trop strictes.
Solutions : 1. Vérifiez les permissions des fichiers 2. Désactivez temporairement les plugins de sécurité 3. Vérifiez les règles dans .htaccess
Erreur 404 sur les pages produits
Causes : Permaliens cassés.
Solution : Allez dans Réglages > Permaliens et cliquez sur Enregistrer (sans rien changer). Cela régénère les règles de réécriture.
Erreur "Maximum execution time exceeded"
Cause : Un script PHP prend trop de temps.
Solutions :
1. Augmentez max_execution_time dans php.ini ou via cPanel
2. Optimisez l'opération en cours (import trop volumineux par exemple)
3. Divisez les opérations lourdes en lots plus petits
Méthode de diagnostic générale 🔺
Face à n'importe quel problème, suivez cette méthode systématique.
Étape 1 : reproduire le problème
Notez précisément les étapes pour reproduire le bug. Un problème qu'on ne peut pas reproduire est difficile à résoudre.
Étape 2 : consulter les logs
- WooCommerce > État > Logs pour les erreurs WooCommerce
- wp-content/debug.log pour les erreurs PHP (si WP_DEBUG est activé)
- Logs serveur via cPanel ou votre hébergeur
Étape 3 : vérifier l'état du système
Allez dans WooCommerce > État et vérifiez : - Version PHP (8.0+ recommandée) - Limite mémoire (128M minimum, 256M recommandé) - Mises à jour en attente - Erreurs signalées en rouge
Étape 4 : isoler le problème
- Testez avec le thème Storefront
- Désactivez tous les plugins sauf WooCommerce
- Le problème persiste ? C'est WooCommerce ou WordPress. Sinon, c'est un thème ou plugin.
Étape 5 : chercher une solution
- Documentation officielle WooCommerce
- Forums WordPress.org
- Stack Overflow avec les tags appropriés
- Support du plugin/thème concerné
Étape 6 : documenter
Une fois le problème résolu, notez ce qui s'est passé et comment vous l'avez résolu. La prochaine fois, vous irez plus vite.
Quand faire appel à un professionnel 🔺
Certaines situations dépassent le dépannage basique :
- Piratage ou malware sur le site
- Migration complexe qui a mal tourné
- Performances désastreuses malgré toutes les optimisations
- Conflits impossibles à résoudre entre extensions essentielles
- Personnalisations cassées après une mise à jour majeure
Dans ces cas, un développeur WordPress/WooCommerce expérimenté vous fera gagner du temps et évitera d'aggraver la situation.
Besoin d'aide urgente ? Notre agence web intervient rapidement sur les problèmes WooCommerce critiques. Contactez-nous.
En résumé
Le dépannage WooCommerce suit une méthode logique : reproduire le problème, consulter les logs, isoler la cause (thème, plugin, configuration), puis appliquer la solution appropriée. La plupart des problèmes proviennent de conflits de plugins, de cache mal configuré, ou de paramètres incorrects. Gardez toujours une sauvegarde récente avant toute intervention. Documentez vos résolutions pour gagner du temps à l'avenir. Et n'hésitez pas à faire appel à un professionnel quand le problème dépasse vos compétences techniques.
Navigation : ← Extensions et Personnalisation | Dépannage