Dépannage WordPress
Images WordPress absentes ou cassées : diagnostic complet
Une image absente peut venir d’un fichier introuvable, d’une URL erronée, d’une taille non générée, d’un blocage CDN, d’un lazy-load ou simplement d’un CSS qui la masque. Le pictogramme cassé et l’espace vide ne se diagnostiquent pas de la même façon.
Ce que ce symptôme signifie réellement
Le panneau Réseau donne le statut et l’URL réellement demandée. HTTP 404, 403, 5xx, contenu HTML servi comme image ou requête annulée orientent vers des causes différentes.
WordPress stocke la pièce jointe et ses métadonnées en base, mais les fichiers et leurs variantes résident sur le stockage. Une migration partielle peut désynchroniser les deux.
Avant toute modification : préserver les preuves et le retour arrière
Notez l’heure, l’URL, le message exact, le code HTTP et le dernier changement connu. Vérifiez ensuite qu’une sauvegarde récente couvre bien les fichiers et la base de données, qu’elle est lisible et qu’un retour arrière limité est possible. Une sauvegarde non testée ne suffit pas pour une intervention risquée.
- Ne transmettez jamais de mot de passe, clé privée, jeton, fichier
wp-config.phpou export de base dans un formulaire ou une capture. - Travaillez d’abord sur un staging ou une copie isolée lorsque le diagnostic exige une mise à jour, une modification de code ou une opération de base de données.
- Conservez les journaux et les fichiers suspects avant nettoyage : ils peuvent être nécessaires pour comprendre la cause ou vérifier l’étendue d’un incident.
Diagnostic : avancer du signal le plus fiable au test le moins intrusif
Ouvrez l’URL de l’image directement et inspectez src, srcset, dimensions calculées, type MIME et règles de cache.
- Comparer l’URL HTML, l’URL de la médiathèque et le fichier présent sur le stockage.
- Vérifier statut, type MIME, CORS, redirections HTTP/HTTPS et éventuelle URL de CDN ou d’optimisation.
- Désactiver visuellement le lazy-load dans DevTools sans modifier le site pour voir si la ressource est bien chargée.
- Contrôler CSS, conteneur, ratio, dimensions et présence des tailles WordPress attendues.
Correction : appliquer une action ciblée et réversible
Réparez la relation rompue plutôt que de téléverser une nouvelle copie qui changerait l’URL et les références.
- Restaurer le fichier manquant depuis une sauvegarde vérifiée ou corriger l’URL générée.
- Régénérer uniquement les tailles nécessaires après sauvegarde et contrôle de l’espace disque.
- Corriger le CDN/cache puis purger la seule ressource concernée.
- Ajouter largeur, hauteur et alternatives responsives pour éviter CLS sans imposer une image trop lourde.
Contrôles après correction
Une page qui se recharge ne suffit pas à prouver que le problème est résolu. Contrôlez le parcours concerné, une page non connectée, l’administration, les erreurs console et réseau, les journaux serveur, le cache et les redirections. Vérifiez aussi les écrans mobile et desktop si le symptôme touchait le rendu.
- Aucune image cassée sur les largeurs concernées.
- Texte alternatif pertinent lorsque l’image porte une information.
- Poids, LCP et CLS contrôlés après correction.
Quand arrêter et demander une intervention
Si des centaines de médias ou des métadonnées sont incohérents, inventorie les références et teste une migration sur copie : ne lancez pas une régénération ou un remplacement global sans estimation.