DocumentaçãoKCS da Experience Cloud

Resolver erros SegmentNotFoundException no Adobe Experience Manager

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

Este artigo explica como resolver erros de SegmentNotFoundException no Adobe Experience Manager (AEM) restaurando a partir de um backup, validando a integridade do repositório e executando a manutenção.

Descrição description

SegmentNotFoundException erros no Adobe Experience Manager indicam que o repositório está corrompido ou sem segmentos, o que pode tornar o ambiente do AEM Author inacessível e interromper as operações normais. Normalmente, esses erros são vistos como entradas de log repetidas e uma incapacidade de acessar a instância do autor do AEM. Restaurar do último backup em boas condições e validar a integridade do repositório são etapas críticas para recuperar o ambiente e evitar mais problemas.

Ambiente

Adobe Experience Manager (AEM) Managed Services (todas as versões)

Sintomas

  • SegmentNotFoundException erros nos logs do AEM
  • Incapacidade de acessar ou usar o ambiente do AEM Author
  • Solicitações para restaurar o último backup em funcionamento conhecido

Causa

SegmentNotFoundException erros geralmente são causados por repositório corrompido ou segmentos ausentes, geralmente exigindo restauração do backup e compactação do repositório para resolver e evitar recorrência.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Identifique o backup válido mais recente do seu ambiente AEM, garantindo que ele inclua todos os arquivos necessários, como o repositório, o armazenamento de dados e os índices.

  2. Restaurar o backup no ambiente AEM de acordo com os procedimentos de backup e restauração de sua organização. Verifique se todos os componentes (repositório, armazenamento de dados, índices) foram restaurados para os locais corretos.

  3. Após a restauração, execute verificações de consistência de repositório, armazenamento de dados e índice para confirmar a integridade do ambiente restaurado. Para a verificação de consistência do índice, use a ferramenta de execução do Oak com os parâmetros apropriados para seu ambiente. Exemplo de comando:

    java -jar oak-run.jar index --index-consistency-check <datastore-config-path> <segmentstore-path>

    Substitua <datastore-config-path> e <segmentstore-path> pelos caminhos corretos para seu ambiente.

  4. Revise o resultado das verificações de consistência para garantir que todos os índices sejam relatados como válidos.

  5. Execute uma compactação offline do repositório para otimizar o armazenamento e evitar mais problemas de segmento. Agende a compactação offline regular e desative a compactação online para reduzir o risco de corrupção do segmento.

  6. Monitore o ambiente para a recorrência de SegmentNotFoundException erros. Se o problema se repetir, analise os logs de fluxos de trabalho ou processos de longa duração que possam contribuir para a corrupção do segmento.

  7. (Opcional) Para capturar despejos de heap ou thread para análise adicional, use as ferramentas Java padrão, como o jstack ou o jmap, no processo do AEM, seguindo os procedimentos de sua organização.

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