Resolução de URLs canônicos e de mapa de site incorretos ou duplicados da configuração de domínio e protocolo do AEM

As tags canônicas geradas pela AEM e os URLs de mapa de site mostram o domínio errado, o protocolo errado, caminhos relativos ou tags canônicas duplicadas quando as propriedades de página, o Externalizador, os cabeçalhos de solicitação ou a lógica do modelo não estão configurados corretamente. As causas mais comuns são uma configuração de domínio Externalizador ausente, um cabeçalho X-Forwarded-Proto ausente, regras clientheaders inadequadas do Dispatcher ou lógica de modelo que emite uma segunda tag canônica. Corrigir a propriedade da página e as configurações do Externalizador, garantir que o cabeçalho do protocolo atinja o AEM e remover a lógica do modelo duplicado restaura os URLs canônicos e de mapa de site corretos.

Descrição description

Problema: o AEM emite URLs canônicos e de mapa de site incorretos, duplicados ou relativos

Descrição

Os sites no AEM exibem URLs canônicos incorretos — http em vez de https, URLs relativos ou URLs completos ausentes — ou geram mapas de site que contêm URLs relativos em vez de absolutos. Em alguns casos, o AEM injeta uma tag canônica padrão quando uma implementação personalizada já gera uma, produzindo duplicatas. Propriedades de página configuradas incorretamente, uma configuração de domínio Externalizador ausente, cabeçalhos X-Forwarded-Proto ausentes, regras clientheaders inadequadas do Dispatcher ou lógica de nível de modelo que emite tags canônicas automaticamente. Todos esses sintomas são acionados.

Ambiente:

Problema/sintomas:

Causa raiz:

O AEM determina URLs canônicos e de mapa de site a partir de uma combinação de propriedades de página, configuração do Externalizador, cabeçalhos de solicitação (especialmente X-Forwarded-Proto), mapeamentos do resolvedor de recursos e lógica específica de modelo. Quando qualquer um desses estiver ausente, configurado incorretamente ou for substituído, o AEM gera URLs incorretos, duplicados ou relativos. Alguns comportamentos de mapa de site também são limitações no módulo Apache Sling Sitemap.

Como confirmar

Resolução resolution

Inspecione os cabeçalhos de solicitação de entrada com DevTools de navegador ou curl para verificar se o cabeçalho está presente. Se estiver ausente, atualize as regras do CDN ou do balanceador de carga.
​3. Para o AEMaaCS, revise a configuração do OSGi implantada via Cloud Manager para org.apache.felix.http.sslfilter.SslFilter, com os seguintes valores de campo:

Após a implantação, exiba a origem da página para confirmar se a geração canônica usa https.
​4. Corrija URLs relativos ou um domínio ausente no mapa do site. Confirme se a entrada sitemap-index.xml está sendo usada — URLs absolutas geralmente aparecem apenas em sitemap-index.xml e não nos arquivos filho sitemap.xml. Em seguida, verifique se a configuração de domínio do Externalizador é implantada por código, usando a configuração com.day.cq.commons.impl.ExternalizerImpl-publish. Adicione um link de teste simples usando externalizer.externalLink ou externalizer.publishLink para confirmar se o Externalizador produz URLs absolutos.
​5. Gere mapas de site usando os recursos prontos para uso do AEM. Confirme se Gerar Mapa do Site está habilitado ou desabilitado corretamente em um nível por página. Para páginas marcadas como uma raiz de mapa de site, o AEM gera sitemap.xml e sitemap-index.xml. Acesse /content/<path>.sitemap-index.xml ou /content/<path>.sitemap.xml diretamente para confirmar se o XML esperado foi produzido. Se os URLs não retornarem nada, confirme se a página foi publicada. Se você usa mapas de site do Edge Delivery Services (EDS), observe que lastmod e changefreq não são suportados — essa é uma limitação grave, portanto, não tente personalizar o mapa de site do EDS.
​6. Para o MSM ou sites multilíngues no AEMaaCS, use o Mapa de site Sling integrado com um sling:sitemapRoot no nível da página. O gerador de mapa de site ACS Commons não é compatível. Confirme se sling:sitemapRoot = true está presente em cada raiz de idioma. Em seguida, acesse <langroot>.sitemap-index.xml para confirmar se cada raiz de idioma produz seu próprio mapa de site.

Validação

Leitura relacionada