DocumentaçãoKCS da Experience Cloud

Publicação de páginas com fragmentos de conteúdo profundamente aninhados

Última atualização: 1 de agosto de 2026

Este artigo descreve como lidar com situações em que as páginas do AEM Sites que fazem referência a fragmentos de conteúdo aninhados não são publicadas por causa de tempos limite durante o processo de pesquisa de referência recursiva.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (todas as versões)

Problema/Sintomas

Ao publicar páginas do AEM Sites que fazem referência a fragmentos de conteúdo com referências aninhadas profundas ou amplas, a página não aparece no payload Gerenciar publicação e não é publicada. Isso ocorre quando um fragmento de conteúdo faz referência a muitos outros fragmentos de conteúdo, resultando em milhares de referências aninhadas e vários níveis de aninhamento. O processo de verificação de referência fica lento e pode expirar, impedindo que a página seja incluída no fluxo de trabalho de publicação. Nenhuma mensagem de erro explícita é exibida na interface do usuário, mas a página esperada não aparece no conteúdo da publicação.

Causa

A pesquisa de referência recursiva por fragmentos de conteúdo profundamente aninhados pode causar degradação do desempenho e tempos limite, impedindo que as páginas sejam incluídas na carga da publicação. Desativar a pesquisa recursiva melhora o desempenho, mas requer gerenciamento manual da publicação de fragmento aninhado.

Resolução resolution

Para corrigir o problema em que as páginas do AEM Sites que fazem referência a fragmentos de conteúdo profundamente aninhados não são publicadas, siga estas etapas:

  1. Desative a pesquisa recursiva de referência de fragmento de conteúdo atualizando a configuração para com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl e definindo a opção para desabilitar a pesquisa recursiva de referência de fragmento de conteúdo.

  2. Atualize a configuração por meio do Cloud Manager:

    • No projeto do Cloud Manager, adicione ou atualize o arquivo de configuração OSGi para com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl.
    • Definir "enable.recursive.cf.reference.search": false na configuração.
    • Confirme e implante a configuração por meio do pipeline da Cloud Manager.

  3. Como alternativa, atualize a configuração por meio do Console OSGi em ambientes locais ou de não produção:

    • Faça logon na instância do autor do AEM.
    • Navegue até /system/console/configMgr.
    • Pesquisar por ActivationReferenceSearchServiceImpl.
    • Edite a configuração e defina a pesquisa de referência recursiva do Fragmento do conteúdo como false.
    • Salve a configuração.

  4. Depois de desabilitar a pesquisa recursiva, tente publicar a página afetada novamente usando Gerenciar publicação. A página agora deve ser incluída na carga da publicação e publicada com sucesso.

  5. Publique manualmente os fragmentos de conteúdo aninhados profundamente, conforme necessário. Com a pesquisa recursiva desativada, somente as referências de primeiro nível são resolvidas automaticamente. Verifique se todos os fragmentos de conteúdo aninhados necessários foram publicados manualmente por meio dos consoles CF/Assets ou incluindo pastas CF relevantes no processo de publicação.

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