DocumentaçãoKCS da Experience Cloud

Resolução de SegmentNotFoundException durante a sincronização do fluxo de trabalho no AEM Forms 6.5

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

Este artigo explica como resolver falhas de sincronização de fluxo de trabalho e SegmentNotFoundException erros que podem ocorrer no Adobe Experience Manager (AEM) Forms 6.5 após a manutenção agendada, especialmente quando a compactação completa do repositório se sobrepõe a operações de gravação intensas.

Descrição description

Ambiente

Adobe Experience Manager (AEM) Forms 6.5 (OSGi, Independente)

Problema/Sintomas

  • A sincronização do fluxo de trabalho falha ou está ausente após a manutenção programada.
  • Os envios de formulários e fluxos de trabalho não podem continuar durante o período afetado.
  • O problema é resolvido automaticamente após algum tempo.
  • O seguinte erro aparece nos logs para os trabalhos de fluxo de trabalho afetados: org.apache.jackrabbit.oak.segment.SegmentNotFoundException
  • O problema é específico de dias em que uma compactação completa é executada, não durante operações de manutenção mais leves.

Causa

Esse problema ocorre porque o processo de compactação completa recupera arquivos TAR de antiga geração que ainda são referenciados por tarefas de fluxo de trabalho ativas. Se as operações de gravação intensa (como uma sincronização LDAP completa) se sobrepõem à compactação completa, os segmentos exigidos pelos fluxos de trabalho em andamento são excluídos, resultando em SegmentNotFoundException erros.

Resolução resolution

Siga estas etapas para resolver esse problema:

  1. Valide o procedimento em um ambiente inferior (não relacionado à produção) para entender os comandos, a saída esperada e o processo geral.

  2. Antes de fazer qualquer alteração na produção, faça um backup ou snapshot completo e consistente do repositório.

  3. Execute uma verificação de consistência do repositório usando a ferramenta oak-run:

    1. Certifique-se de que a instância do AEM esteja offline antes de executar operações no nível do repositório.

    2. Execute o seguinte comando (substitua <path-to-oak-run.jar> e <path-to-repository> pelos caminhos reais):

      java -jar <path-to-oak-run.jar> check <path-to-repository>

    3. Execute a análise em uma cópia de backup do repositório de produção, se possível, para minimizar o tempo de inatividade.

  4. Revise e ajuste a programação da sincronização LDAP e das tarefas de compactação completas para evitar sobreposições, especialmente durante operações de alta gravação. Considere executar a compactação completa em um horário diferente ou garantir que não ocorram operações pesadas de gravação durante a compactação.

  5. Depois de implementar as alterações, monitore a execução do fluxo de trabalho e os logs para qualquer recorrência de SegmentNotFoundException erros:

  6. Verifique o error.log do AEM e os logs de fluxo de trabalho para o padrão SegmentNotFoundException.

  7. Se os problemas persistirem, repita a verificação de consistência e o agendamento da tarefa de revisão para ajustes adicionais.

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