DocumentaçãoKCS da Experience Cloud

Problemas de redução de URL do AEM com remoção de extensão e mapeamentos do Sling

Última atualização: 21 de junho de 2026

A redução de URL no AEM pode falhar ao tentar remover extensões, ocultar caminhos internos ou substituir segmentos. Para corrigir o problema, use mecanismos de regravação compatíveis, valide mapeamentos e reconheça restrições da plataforma.

Descrição description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • AEM no local (6.5 e anterior)

Problema/Sintomas

  • URLs curtos não resolvem Publicar, mas funcionam em ambientes locais
  • A extensão .html não foi removida nas implantações de nuvem
  • URLs com # fragmentos não são mapeados ou regravados
  • Os pipelines de reescrita se aplicam a caminhos de conteúdo não intencionais
  • Caminhos reservados como /experiments não podem ser modificados
  • model.json solicitações duplicadas ocorrem em implementações de SPA

Causa raiz

Problemas de redução de URL ocorrem devido a recursos não compatíveis em ambientes de nuvem, limitações HTTP com fragmentos de URL, mapeamentos Sling mal configurados, configurações de reescrita sobrepostas e caminhos de sistema necessários que não podem ser alterados.

Como confirmar

  • Comparar comportamento entre ambientes locais e de publicação
  • Inspecionar solicitações de rede do navegador para verificar a resolução da URL
  • Verifique se há várias chamadas model.json em implementações de SPA
  • Revisar logs para mapeamento ou reescrever execução de regras

Resolução resolution

Para corrigir o problema:

  1. Use as regras de regravação do Dispatcher ou CDN (como o Apache mod_rewrite) para lidar com a remoção de extensões e a redução de URLs.
  2. Evite tentar mapear ou regravar fragmentos de URL (#), pois eles não são processados no lado do servidor.
  3. Verifique se os pipelines de reescrita têm valores de ordem exclusivos e escopos de caminho distintos.
  4. Não modifique caminhos reservados para o sistema, como /experiments, pois eles são necessários para recursos específicos do produto.
  5. Atualize os mapeamentos do Sling para garantir que URLs curtos sejam resolvidos corretamente em caminhos de conteúdo internos, especialmente para implementações de SPA.
  6. Para configurações no local, configure as regras de regravação no nível do servidor para suportar a remoção da extensão.

Leitura relacionada

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