Documentação

A página inicial não carrega com conteúdo no Adobe Experience Manager

Last update: Fri Jul 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

O AEM as a Cloud Service disponibiliza intermitentemente uma página inicial em branco, interrompendo a experiência do usuário e acionando alertas falsos de tempo de inatividade. O armazenamento em cache prematuro, os serviços não inicializados ou os erros de renderização geralmente causam esse problema. Este artigo explica como corrigi-lo ajustando as regras de cache, revisando o comportamento de aquecimento e adicionando verificações de integridade para componentes personalizados para garantir a entrega de conteúdo confiável.

Descrição description

Ambiente

Esse problema afeta o Adobe Experience Manager (AEM) as a Cloud Service - Sites, especificamente no ambiente de produção.

Problema/Sintomas

A página inicial do é carregada intermitentemente sem conteúdo, servindo uma página vazia. As ferramentas de monitoramento geram vários alertas indicando o tempo de inatividade da página inicial. Embora o problema se resolva em 10 a 20 minutos, ele se repete com frequência. Durante esses períodos, a análise mostra discrepâncias no tamanho da página, e o sistema fornece versões em cache da página vazia.

Resolução resolution

Use as seguintes etapas para resolver esse problema:

  1. Configure regras apropriadas de invalidação de cache para impedir que conteúdo obsoleto ou inconsistente seja distribuído. Inclua localhost ou 127.0.0.1 como ServerAlias na configuração de host virtual para invalidação do dispatcher. Para obter mais informações, consulte Noções básicas sobre o cache do Dispatcher e Páginas em cache invalidadas do AEM.

  2. Desabilite temporariamente o serviço de aquecimento se ele enviar solicitações antes que todos os serviços sejam inicializados, o que pode fazer com que páginas incompletas sejam armazenadas em cache.

  3. Atualize para a versão mais recente do AEM para aplicar correções de erros que resolvam problemas em que erros de renderização resultam em valores nulos em cache.

  4. Revise e atualize os Modelos do Sling em sua base de código (para obter mais informações, consulte Criar um modelo do Sling para o componente):

    • Marque apenas as injeções como opcionais quando necessário.
    • Manipule explicitamente valores nulos no código para evitar exceções de tempo de execução durante a inicialização.

  5. Implemente verificações de integridade OSGi para componentes personalizados críticos para garantir que eles sejam inicializados antes de veicular o tráfego:

    code language-none 
    {
    "hc.name": "Required Custom Components",
    "hc.tags": [ "systemalive", "systemready"] ,
    "components.list": [ "com.example.core.services.impl.RenditionServiceImpl"]
}

    Teste esta configuração localmente acessando /system/console/healthcheck?tags=systemready e confirmando que todos os componentes listados retornam um status OK. Para obter mais informações, consulte Configurando OSGi para AEM as a Cloud Service.

  6. Revise os logs pod durante a inicialização para identificar exceções relacionadas a falhas de renderização ou serviços não inicializados (por exemplo, NullPointerException). Corrija esses problemas garantindo a injeção e a inicialização apropriadas das dependências.

  7. Teste todas as alterações em ambientes de preparo antes da implantação em produção para reduzir o risco de tempo de inatividade ou problemas de cache.

Essas etapas ajudam você a evitar interrupções recorrentes da página inicial e garantir a entrega consistente de conteúdo, solucionando as causas básicas, como erros de inicialização de serviço e erros de configuração de cache.

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