Documentation

Les ressources ZIP renvoient la valeur 404 lors de la publication dans AEM as a Cloud Service ou AEM 6.5 avec Dispatcher

Last update: Tue Jan 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Lorsque les fichiers ZIP sont chargés dans la gestion des ressources numériques AEM, ils s’affichent comme publiés dans l’instance de création, mais renvoient une erreur 404 lors de l’accès à l’instance de publication. D’autres types de ressources tels que les PDF et les images fonctionnent correctement. Cela se produit, car Dispatcher bloque les requêtes ZIP par défaut. Pour corriger ce problème, mettez à jour les règles de filtrage Dispatcher pour autoriser les extensions ZIP.

Description description

Environnement

  • AEM as a Cloud Service (AEMaaCS)
  • AEM 6.5 avec Dispatcher

Problème/Symptômes

  • Les ressources ZIP affichent un statut vert Publié dans l’instance de création AEM.
  • L’accès direct au fichier ZIP lors de la publication (par exemple, /content/dam/.../file.zip) renvoie 404.
  • Les journaux de réplication n’affichent aucune erreur.
  • Les autres types de ressources (PDF, JPEG, SVG, MP4) fonctionnent correctement.
  • Le fait de compresser à nouveau ou de charger de nouveaux fichiers ZIP ne résout pas le problème.

Cause

Les règles de filtrage Dispatcher commencent généralement par une configuration deny-all, puis autorisent de manière sélective uniquement des types de fichiers spécifiques.

Voici quelques exemples de filtres restrictifs :

/0001 { /type "deny" /url "*" }

/0010 {
  /type "allow"
  /extension '(css|gif|jpeg|jpg|js|pdf|png|svg|ttf|woff|woff2|html)'
  /path "/content/*"
}

Comme .zip n’est pas inclus dans la liste des extensions autorisées :

  • Dispatcher bloque la requête.
  • L’instance de publication contient la ressource, mais la requête ne l’atteint jamais.
  • Résultat final : 404 introuvable, même si la réplication a réussi.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

Ajoutez .zip à la liste des extensions autorisées dans les filtres Dispatcher.

  1. Ouvrez votre fichier de configuration Dispatcher.

  2. Ajoutez une règle dédiée pour les fichiers ZIP :

    code language-none 
    /00xx {
        /type "allow"
        /method "GET"
        /path "/content/dam/*"
        /extension "zip"
        }

  3. Vous pouvez également mettre à jour la règle d’autorisation existante pour inclure les zip :

    code language-none 
    /0010 {
        /type "allow"
        /extension '(css|gif|jpeg|jpg|js|pdf|png|svg|ttf|woff|woff2|html|zip)'
        /path "/content/*"
        }

  4. Redéployez la configuration Dispatcher.

  5. Testez à nouveau le téléchargement ZIP.

Lecture connexe

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f