DocumentationExperience Cloud KCS

Les fichiers PNG avec des extensions en majuscules renvoient des erreurs 404 dans AEM Assets

Dernière mise à jour : 13 octobre 2026

Adobe Experience Manager (AEM) Assets peut renvoyer la mention 404 Introuvable pour les ressources PNG publiées avec des extensions de fichier en majuscules lorsqu’elles sont accessibles via Dispatcher, car ses règles de filtrage traitent les extensions comme sensibles à la casse et peuvent autoriser uniquement des extensions en minuscules. Bien que les ressources restent disponibles dans la gestion des ressources numériques, le filtre bloque les requêtes avec des extensions en majuscules. Pour résoudre ce problème, normalisez les noms de fichiers de ressources avec des extensions en minuscules ou mettez à jour les règles de filtrage Dispatcher pour autoriser les extensions PNG en minuscules et en majuscules.

Description description

Environnement

Adobe Experience Manager (AEM) Assets (toutes les versions et tous les modèles de déploiement utilisant Dispatcher)

Problème/Symptômes

Lorsque des ressources présentant des extensions de fichier PNG en minuscules et en majuscules, telles que asset1.png et asset1.PNG, sont chargées vers AEM Assets et référencées dans les canaux AEM Screens ou d’autres composants, les symptômes suivants se produisent :

  • Dans l’environnement de création, les ressources .png et .PNG sont accessibles et renvoient HTTP 200 OK.
  • Dans l’environnement de publication accessible via Dispatcher, les requêtes de ressources .png renvoient HTTP 200 OK.
  • Les requêtes de ressources .PNG renvoient la valeur HTTP 404 introuvable, même si les ressources sont publiées et disponibles dans la gestion des ressources numériques (DAM).

Cause première

Le filtre Dispatcher traite les extensions de fichier comme étant sensibles à la casse. Par défaut, ses règles de filtrage peuvent n’autoriser que les extensions minuscules, telles que .png. Les requêtes de ressources avec des extensions majuscules, telles que .PNG, sont bloquées à moins que les règles de filtrage ne les autorisent explicitement, ce qui entraîne des erreurs HTTP 404 Introuvable.

Résolution resolution

Pour résoudre ce problème, utilisez l’une des méthodes suivantes :

Normaliser les extensions de fichier de ressource (recommandé)

  1. Assurez-vous que tous les noms de fichier des ressources chargées utilisent des extensions en minuscules, telles que .png au lieu de .PNG.
  2. Communiquez cette convention de nommage aux auteurs de contenu et aux équipes pertinentes afin d’éviter que le problème ne se reproduise.

Mettre à jour les règles de filtrage Dispatcher

  1. Recherchez le répertoire de configuration Dispatcher et ouvrez le fichier de configuration des règles de filtrage.
  2. Ajoutez ou mettez à jour une règle pour autoriser les extensions .png et .PNG pour le chemin d’accès DAM approprié.
  3. Enregistrez les modifications dans le fichier de configuration.
  4. Testez la configuration dans un environnement de test et vérifiez que les ressources .png et .PNG sont accessibles.
  5. Déployez la configuration mise à jour dans l’environnement en ligne.
  6. Videz le cache pour vous assurer que les modifications prennent effet.
  7. Vérifiez que les ressources dotées des extensions .png et .PNG sont accessibles via l’environnement de publication.
recommendation-more-help
experience-cloud-kcs-help-kbarticles