Les images de vos produits WooCommerce ont disparu
Une image de produit qui a disparu n’est presque jamais un bug WooCommerce : c’est une rupture de lien entre trois éléments qui doivent rester synchronisés, l’identifiant enregistré en base, le fichier réel dans wp-content/uploads, et l’adresse à laquelle WordPress va le chercher. Un seul des trois qui bouge, et la photo est remplacée par le cadre gris par défaut.
Comment je procède
-
Délimitation du périmètre
Je vérifie si quelques fiches sont touchées ou toute la médiathèque, et si le problème apparaît côté public, côté administration, ou les deux.
-
Contrôle de l’identifiant en base
Je regarde la métadonnée _thumbnail_id de chaque produit concerné : si elle pointe vers un attachement supprimé ou dont l’ID a changé, l’image bascule automatiquement sur le visuel par défaut.
-
Vérification du domaine enregistré
Après une migration ou un changement de domaine, je vérifie la cohérence entre siteurl, home et les URL d’image parfois codées en dur dans d’anciens contenus plutôt qu’en chemin relatif.
-
Contrôle des fichiers réels
Je vérifie que wp-content/uploads a bien été intégralement transféré, et qu’aucun fichier n’a été corrompu par une extension d’optimisation d’image interrompue en cours de traitement.
-
Vérification du .htaccess et d’un éventuel CDN
Je contrôle qu’aucune règle de sécurité ni configuration CDN mal réglée ne bloque l’accès à wp-content/uploads, ce qui provoque des erreurs 404 alors que la base de données est parfaitement correcte.
Ce que je traite régulièrement
- Un cadre gris à la place de la photo sur certaines fiches produit, alors que l’image existait avant
- Toutes les images disparues d’un coup après une migration ou une restauration de sauvegarde ancienne
- Les images s’affichaient correctement en local ou sur l’ancien domaine, plus sur le nouveau
- La médiathèque WordPress est vide ou très incomplète alors que le site fonctionnait normalement
- Le fichier image renvoie une erreur 404 alors que la fiche produit le référence correctement en base
D’où viennent les images manquantes
Le lien entre un produit et sa photo est stocké dans postmeta sous la clé _thumbnail_id, un simple identifiant d’attachement. Si cet attachement a été supprimé, ou si son ID a changé, ce qui arrive fréquemment après une migration ou une restauration à partir d’une sauvegarde ancienne, le produit retombe sur l’image par défaut sans qu’aucune erreur ne s’affiche.
Après un changement de domaine, des URL d’image codées en dur dans d’anciens contenus, au lieu d’un chemin relatif, continuent de pointer vers l’ancienne adresse : un désaccord entre siteurl et home dans les réglages est une cause fréquente de ce comportement.
Les fichiers eux-mêmes peuvent aussi être simplement absents de wp-content/uploads si une migration n’a pas copié ce dossier, ou corrompus si une extension d’optimisation d’image s’est arrêtée en plein traitement. Enfin, un CDN mal configuré ou une règle .htaccess ajoutée par excès de prudence pour la sécurité peut mettre en erreur 404 l’ensemble des images pendant que la base de données reste, elle, parfaitement correcte.
Autres sujets liés
-
Migration WordPress / WooCommerce
Les images comptent parmi les pertes les plus fréquentes lors d’un changement d’hébergeur ou de domaine.
-
Contrat de maintenance
Une sauvegarde vérifiée régulièrement évite ce type de perte après un incident.
-
Toutes les interventions WooCommerce
Les autres pannes et évolutions que je traite sur WooCommerce.
Décrivez votre besoin en 1 minute
Quelques questions ciblées pour que je vous réponde avec une estimation, pas avec un questionnaire de plus.