Documentazione

Le risorse ZIP restituiscono 404 al momento della pubblicazione in AEM as a Cloud Service o AEM 6.5 con Dispatcher

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

Quando i file ZIP vengono caricati in AEM DAM, vengono visualizzati come pubblicati nell'istanza di authoring ma restituiscono un errore 404 quando si accede al processo di pubblicazione. Altri tipi di risorse, come PDF e immagini, funzionano correttamente. Questo accade perché Dispatcher blocca le richieste ZIP per impostazione predefinita. Per risolvere questo problema, aggiorna le regole del filtro Dispatcher per consentire le estensioni ZIP.

Descrizione description

Ambiente

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

Problema/Sintomi

  • Le risorse ZIP presentano uno stato verde Pubblicato in AEM Author.
  • L'accesso diretto al file ZIP al momento della pubblicazione (ad esempio, /content/dam/.../file.zip) restituisce 404.
  • I registri di replica non mostrano errori.
  • Altri tipi di risorse (PDF, JPEG, SVG, MP4) funzionano correttamente.
  • Il nuovo comando di compressione o caricamento di nuovi file ZIP non risolve il problema.

Causa

Le regole del filtro di Dispatcher in genere iniziano con una configurazione deny-all e quindi consentono selettivamente solo tipi di file specifici.

Esempio di filtri restrittivi spesso includono:

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

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

Poiché .zip è non incluso nell'elenco delle estensioni consentite:

  • Dispatcher blocca la richiesta.
  • L’istanza Publish dispone della risorsa, ma la richiesta non la raggiunge mai.
  • Risultato finale: 404 non trovato, anche se la replica ha esito positivo.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito:

Aggiungi .zip all'elenco delle estensioni consentite nei filtri di Dispatcher.

  1. Apri il file di configurazione di Dispatcher.

  2. Aggiungi una regola dedicata per i file ZIP:

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

  3. In alternativa, aggiornare la regola di autorizzazione esistente per includere zip:

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

  4. Ridistribuisci la configurazione di Dispatcher.

  5. Prova di nuovo il download ZIP.

Lettura correlata

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