DocumentaçãoKCS da Experience Cloud

Instância do autor de preparo inativa devido a problemas incompatíveis de pacote e conteúdo após a restauração

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

Este artigo descreve como recuperar uma instância do autor de estágio do Adobe Experience Manager que falha ao iniciar ou fornecer conteúdo após uma restauração, devido a pacotes incompatíveis e usuários de serviço ausentes.

Descrição description

Ambiente

Adobe Experience Manager (AEM)

Problema/Sintomas

  • A instância do autor do estágio fica inacessível por um período estendido (mais de 8 horas).
  • Procurar a instância do autor resulta em erros ou em páginas em branco.
  • A página de logon em /libs/granite/core/content/login.html está inacessível.
  • Os logs de erros mostram problemas com pacotes incompatíveis e usuários de serviço ausentes.
  • Erros relacionados a org.apache.aries.spifly.dynamic.bundle e linkcheckerTransformer estão presentes.
  • A restauração a partir de vários backups e a reinicialização do AEM não resolvem o problema.

Os seguintes erros podem ser observados nos logs:

Erro ao carregar o pacote org.apache.aries.spifly.dynamic.bundle: não compatível com o Java 21.

Erro na configuração do linkcheckerTransformer em
/apps/< application> /config/rewriter/versioned-clientlibs.

Erros ausentes do usuário do serviço.

Causa

Restaurar uma instância de autor com um pacote incompatível (org.apache.aries.spifly.dynamic.bundle) sem suporte no Java21, configurado incorretamente linkchecker transformer e usuários de serviço ausentes causou falhas de inicialização e acesso ao conteúdo.

Resolução resolution

Para corrigir o problema, siga estas etapas:

  1. Identifique o backup válido mais recente da instância do autor e restaure a instância do autor usando esse backup.
  2. Após a restauração, verifique se há pacotes incompatíveis nos logs de erro, como org.apache.aries.spifly.dynamic.bundle.
  3. Remova o pacote incompatível do console OSGi ou do sistema de arquivos e reinicie a instância do AEM.
  4. Se aparecerem erros relacionados a linkcheckerTransformer, atualize a configuração em /apps/<application>/config/rewriter/versioned-clientlibs.
  5. Remova ou corrija a configuração linkchecker conforme necessário e reinicie o AEM para aplicar as alterações.
  6. Revise os logs de erro para erros ausentes do usuário de serviço. Verifique se todos os usuários de serviço necessários estão presentes e configurados corretamente.
  7. Se caminhos de conteúdo específicos estiverem ausentes (por exemplo, /content/<content-root>/us/en), crie um pacote a partir da instância do publicador para o caminho necessário.
  8. Instale o pacote na instância do autor.
  9. Valide se o conteúdo está disponível agora. Confirme se a página de logon e a interface do usuário de criação estão acessíveis.
  10. Verifique se todo o conteúdo e configurações necessários estão presentes.
recommendation-more-help
experience-cloud-kcs-help-kbarticles