WebSentinel.
Tutoriels

WooCommerce cassé après mise à jour : diagnostic et correction rapide

· Nicolas Pivaut

Vous venez de mettre à jour WooCommerce, WordPress ou un plugin. Et maintenant votre boutique ne fonctionne plus. Écran blanc, checkout inaccessible, erreur 500 : vous avez perdu des ventes depuis que ça a planté.

Ce guide couvre les trois scénarios les plus fréquents après une mise à jour WooCommerce et les étapes pour y remédier, du diagnostic rapide à la restauration complète.

Les 3 scénarios les plus fréquents après une mise à jour WooCommerce

Scénario 1 : le checkout est cassé

La page de paiement s’affiche en blanc, les champs du formulaire disparaissent, ou le bouton “Commander” ne répond plus. C’est le scénario le plus courant et le plus impactant : votre boutique tourne mais ne vend plus.

Cause la plus probable : un plugin de paiement (Stripe, PayPal, Mollie) ou un plugin de sécurité (Wordfence, WP Rocket) n’est pas compatible avec la nouvelle version de WooCommerce.

Scénario 2 : écran blanc (White Screen of Death)

Tout ou partie du site affiche une page complètement blanche. Parfois seulement le front, parfois le back-office aussi. Aucun message d’erreur visible.

Cause la plus probable : erreur PHP fatale déclenchée par un plugin ou le thème, incompatible avec la mise à jour. PHP tente d’exécuter du code qui n’existe plus ou a changé de structure.

Scénario 3 : les emails de commande ne partent plus

Les commandes semblent passer normalement, mais vos clients ne reçoivent pas leur confirmation. Vous non plus. Les commandes s’enregistrent dans le back-office, mais la notification par email est silencieuse.

Cause la plus probable : une mise à jour a réinitialisé les réglages SMTP, ou un plugin d’envoi d’emails (FluentSMTP, WP Mail SMTP) est entré en conflit avec WooCommerce.

Diagnostic pas à pas

Avant de toucher quoi que ce soit, notez ce que vous observez : page concernée, message d’erreur exact, heure à laquelle ça a commencé, quelle(s) mise(s) à jour ont été faites. Ces informations sont essentielles pour un diagnostic rapide.

Étape 1 : activer le mode debug WordPress

Ajoutez ces lignes dans votre fichier wp-config.php (avant la ligne /* That's all, stop editing! */) :

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Le fichier de log sera créé dans /wp-content/debug.log. Rechargez la page problématique et consultez ce fichier : les erreurs PHP y apparaissent avec le fichier et la ligne concernée.

Désactivez le debug après le diagnostic pour ne pas exposer vos erreurs aux visiteurs.

Étape 2 : vérifier les logs WooCommerce

Dans votre back-office : WooCommerce > État > Journaux. Les erreurs récentes liées aux paiements, webhooks ou plugins WooCommerce y sont consignées.

Étape 3 : désactiver les plugins un par un

C’est la méthode la plus fiable pour isoler un conflit. Via FTP ou le gestionnaire de fichiers de votre hébergeur :

  1. Renommez le dossier /wp-content/plugins/ en /wp-content/plugins_backup/
  2. Testez si le site refonctionne
  3. Si oui, renommez le dossier en /wp-content/plugins/ et désactivez les plugins un par un depuis le back-office en commençant par ceux mis à jour récemment

Via l’interface WordPress : si vous avez encore accès au back-office, allez dans Extensions > Extensions installées et désactivez les plugins récemment mis à jour.

Les plugins à tester en priorité :

  • Plugin de paiement (Stripe, PayPal, WooCommerce Payments)
  • Plugin de cache (WP Rocket, W3 Total Cache, LiteSpeed)
  • Plugin de sécurité (Wordfence, iThemes Security)
  • Plugin de livraison ou de taxes

Étape 4 : tester avec le thème par défaut

Si la désactivation des plugins ne résout pas le problème, testez avec un thème WordPress par défaut (Twenty Twenty-Four ou Twenty Twenty-Five). Certains thèmes utilisent des templates WooCommerce personnalisés qui peuvent casser après une mise à jour majeure.

Dans le back-office : Apparence > Thèmes et activez un thème par défaut.

Restaurer depuis une sauvegarde

Si le diagnostic ne donne rien ou si vous manquez de temps, la restauration depuis sauvegarde est la solution la plus rapide pour remettre la boutique en ligne.

Ce dont vous avez besoin :

  • Une sauvegarde récente de la base de données (fichier SQL)
  • Une sauvegarde des fichiers WordPress (archive zip ou tar.gz)
  • L’accès à votre hébergeur (cPanel, Plesk, phpMyAdmin)

La procédure :

  1. Exportez votre sauvegarde depuis votre plugin de backup (UpdraftPlus, BackWPup, Jetpack)
  2. Restaurez les fichiers via FTP
  3. Restaurez la base de données via phpMyAdmin
  4. Vérifiez que le site fonctionne
  5. Notez quelle version de WooCommerce était stable

Si vous n’avez pas de sauvegarde récente, votre hébergeur en conserve souvent une de son côté (cPanel > Sauvegardes, ou support hébergeur). Demandez-leur.

Mettre à jour WooCommerce sans risque la prochaine fois

La meilleure façon d’éviter ce scénario, c’est de ne jamais mettre à jour en production directement.

Utiliser un staging

Un environnement de staging est une copie de votre boutique, accessible sur un sous-domaine ou une URL de test, sans impact sur vos ventes.

  • O2Switch, WP Engine, Kinsta et la plupart des hébergeurs premium proposent un staging en un clic
  • Vous testez la mise à jour sur le staging, vérifiez que tout fonctionne, puis vous poussez en production

Ne jamais mettre à jour plusieurs composants le même jour

Mettez à jour WooCommerce seul. Attendez 24h. Testez. Puis mettez à jour les plugins de paiement. Cette méthode permet d’isoler rapidement la source d’un problème si quelque chose casse.

Faire une sauvegarde manuelle juste avant chaque mise à jour

Même si votre hébergeur fait des sauvegardes automatiques, créez une sauvegarde manuelle avec UpdraftPlus ou BackWPup juste avant de lancer une mise à jour. En cas de problème, vous pouvez restaurer en 5 minutes.

Quand appeler un expert

Certaines situations nécessitent une intervention technique rapide :

  • La boutique est en panne pendant les heures de pointe ou une campagne
  • Vous n’avez pas accès à FTP ou au back-office
  • Vous n’avez pas de sauvegarde et le site est complètement inaccessible
  • Le problème persiste malgré le diagnostic et la désactivation des plugins

Notre service urgence WooCommerce intervient le jour même pour remettre votre boutique en ligne. Nous diagnostiquons le conflit, restaurons ou corrigeons, et vérifions l’ensemble du tunnel d’achat.

Pour éviter que cette situation se reproduise, notre forfait maintenance WooCommerce inclut les mises à jour réalisées sur staging avant de passer en production, plus des sauvegardes automatisées quotidiennes.

Ressources complémentaires

Articles similaires

Conformité légale

Bouton de rétractation conforme

Module sur-mesure + installation + support 12 mois. WooCommerce, PrestaShop, Shopify. 149 €.

En savoir plus