DocumentaçãoKCS da Experience Cloud

Adobe Experience Manager: correção de links de navegação e ativos corrompidos devido à falta de mapeamentos de caminho de dispatcher

Última atualização: 24 de julho de 2026

Este artigo explica como resolver links de navegação e ativos corrompidos no Adobe Experience Manager (AEM) Sites quando os mapeamentos de caminho do dispatcher estão ausentes ou incompletos após a manutenção ou a atualização do cache do dispatcher.

Descrição description

Ambiente

Adobe Experience Manager Sites (AEM Sites), todas as versões compatíveis e modelos de implantação que usam o módulo Dispatcher

Sintomas

Após a manutenção programada ou a atualização do cache do dispatcher, os links de navegação e os caminhos de ativos de imagem no site são interrompidos. Os links afetados geram URLs que começam com /content/<site-context>/... (que funcionam) ou /<site-context>/... (que não funcionam). Antes do problema, nenhum desses padrões de caminho aparecia em caminhos de link. O problema também afeta caminhos de imagem, resultando em imagens quebradas em todo o site.

Causa

Um mapeamento de caminho de dispatcher ausente ou incompleto para o contexto do site faz com que sejam gerados URLs que não são resolvidos corretamente. Essa lacuna de configuração geralmente é exposta depois que o cache do dispatcher limpa as atividades de manutenção, levando a URLs não mapeados e links e ativos corrompidos.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Revise os arquivos de configuração do dispatcher para ver se há mapeamentos de caminho ausentes relacionados ao caminho de contexto do site.

  2. Inspecione os arquivos de mapeamento (como aem-base-uris.txt ou equivalente) para garantir que todos os mapeamentos necessários estejam presentes para o contexto do site.

  3. Adicione um mapeamento de /<site-context> a /content/<site-context> na configuração do Dispatcher. Por exemplo:

    /<site-context> /content/<site-context>

  4. Se necessário, configure um redirecionamento do Dispatcher 301 para URLs personalizados canônicos para garantir uma resolução de URL consistente.

  5. Depois de atualizar a configuração, limpe o cache do dispatcher para aplicar as alterações.

  6. Verifique se os links de navegação e os caminhos de ativos de imagem agora são resolvidos corretamente no site.

  7. Se os agentes de replicação foram pausados durante a manutenção, retome a operação.

recommendation-more-help
experience-cloud-kcs-help-kbarticles