Documentação

Os ativos ZIP retornam 404 ao publicar no AEM as a Cloud Service ou AEM 6.5 com o Dispatcher

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

Quando arquivos ZIP são carregados no AEM DAM, eles são exibidos como publicados no Author, mas retornam um erro 404 quando acessados em Publish. Outros tipos de ativos, como PDFs e imagens, funcionam bem. Isso acontece porque o Dispatcher bloqueia solicitações ZIP por padrão. Para corrigir isso, atualize as regras de filtro do Dispatcher para permitir extensões ZIP.

Descrição description

Ambiente

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

Problema/Sintomas

  • Os ativos ZIP exibem um status verde Publicado no autor do AEM.
  • Acessar diretamente o ZIP em Publicar (por exemplo, /content/dam/.../file.zip) retorna 404.
  • Os logs de replicação não mostram erros.
  • Outros tipos de ativos (PDF, JPEG, SVG, MP4) funcionam bem.
  • Recompactar ou fazer upload de novos arquivos ZIP não resolve o problema.

Causa

As regras de filtro do Dispatcher geralmente começam com uma configuração negar-tudo e permitem seletivamente apenas tipos de arquivos específicos.

Exemplos de filtros restritivos geralmente incluem:

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

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

Como .zip não está incluído na lista de extensões permitidas:

  • O Dispatcher bloqueia a solicitação.
  • A instância de publicação tem o ativo, mas a solicitação nunca o atinge.
  • Resultado final: 404 Não encontrado, mesmo que a replicação seja bem-sucedida.

Resolução resolution

Siga estas etapas para resolver o problema:

Adicione .zip à lista de extensões permitidas em filtros Dispatcher.

  1. Abra o arquivo de configuração do Dispatcher.

  2. Adicione uma regra dedicada para arquivos ZIP:

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

  3. Como alternativa, atualize a regra de permissão existente para incluir zip:

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

  4. Reimplante a configuração do Dispatcher.

  5. Teste o download do ZIP novamente.

Leitura relacionada

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