« WooCommerce database update required » : la mise à jour de la base WooCommerce

Fiche du décodeur d'erreurs, mise à jour le 12 octobre 2026

AvertissementWooCommerce
Le message affiché
WooCommerce database update required
Autres formulations du même message 3
  • WooCommerce has been updated! To keep things running smoothly, we have to update your database to the newest version.
  • WooCommerce is updating the database in the background. The database update process may take a little while, so please be patient.
  • Note: WP CRON has been disabled on your install which may prevent this update from completing.

Après une mise à jour de l’extension, WooCommerce doit adapter la structure de ses données dans la base. Le bandeau vous demande de lancer cette opération, qui se déroule ensuite en arrière-plan, découpée en petites tâches confiées au planificateur d’actions. Si ces tâches ne s’exécutent pas, le bandeau reste affiché.

Pourquoi cette erreur apparaît

  • L’extension a été mise à jour, mais la mise à jour de la base n’a pas encore été lancée.
  • Les tâches planifiées ne s’exécutent pas : WP-Cron désactivé sans tâche cron de remplacement, ou site protégé qui bloque ses propres appels internes.
  • Le planificateur d’actions accumule des tâches en retard ou en échec.
  • Le serveur interrompt le traitement : délai d’exécution trop court, mémoire insuffisante, base très volumineuse.

Comment corriger le problème

Sauvegarder, puis lancer la mise à jour

Faites une sauvegarde complète (fichiers et base), puis cliquez sur le bouton de mise à jour de la base dans le bandeau. Sur une grosse boutique, choisissez un moment calme : l’opération modifie les tables des commandes et des produits.

Suivre la progression

Le bandeau indique ensuite que la mise à jour tourne en arrière-plan. Son lien mène à la liste des actions planifiées : les tâches woocommerce_run_update_callback doivent quitter, une à une, la liste des actions en attente.

Vérifier que WP-Cron fonctionne

Si rien n’avance, cherchez DISABLE_WP_CRON dans wp-config.php. Si cette constante vaut true, une tâche cron doit être programmée chez l’hébergeur pour appeler wp-cron.php. Vérifiez aussi, dans Outils > Santé du site, qu’aucune protection par mot de passe ou pare-feu ne bloque les appels du site vers lui-même.

Lancer la mise à jour avec WP-CLI

Avec un accès SSH et WP-CLI, cette commande exécute toutes les mises à jour de base en attente, sans dépendre du navigateur ni de WP-Cron. Elle affiche la progression et les éventuelles erreurs.

wp wc update

Lire le journal en cas d’échec

Si une étape échoue, consultez WooCommerce > État > Journaux et les actions en échec du planificateur. Une erreur de mémoire ou de délai d’exécution indique qu’il faut relever ces limites chez l’hébergeur avant de relancer.

Ne lancez jamais cette mise à jour sans une sauvegarde fraîche de la base : en cas d’interruption, c’est elle qui permet de revenir à un état cohérent.

Un autre message d'erreur ? Collez-le dans le décodeur : il le reconnaît et vous oriente vers la bonne fiche.

Ouvrir le décodeur