DocumentaçãoKCS da Experience Cloud

A implantação do AEM Cloud Manager falha devido à falta de importações de pacotes do Apache Tika

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

Este artigo descreve como resolver falhas de pipeline de implantação em ambientes do Adobe Experience Manager Cloud Manager causadas pela falta de importações de pacote do Apache Tika em pacotes de aplicativos personalizados.

Descrição description

Ambiente

  • Adobe Experience Manager (AEM) as a Cloud Service
  • Cloud Manager

Problema/Sintomas

  • O pipeline de implantação falha no ambiente de controle de qualidade durante a etapa de implantação.

  • Todas as etapas de pipeline anteriores (criação, qualidade de código, criação de imagem, trabalho de transformação e atualizações de índice) foram concluídas com êxito.

  • A implantação falha com um erro indicando que os contêineres não estão prontos.

  • Os logs de publicação do AEM mostram repetidos erros de estrutura OSGi relacionados à funcionalidade de extração do PDF, como:

    • NoClassDefFoundError: org/apache/tika/io/IOExceptionWithCause
    • ClassNotFoundException: org.apache.tika.io.IOExceptionWithCause not found

  • Os pacotes Apache Tika fornecidos pela plataforma (org.apache.tika.core, org.apache.tika.parsers) estão presentes e ativos.

  • O pacote de aplicativos personalizado não importa os pacotes org.apache.tika.* necessários, resultando em falhas de carregamento de classe ao fazer referência às classes Tika.

  • O problema pode ser reproduzido em cada execução de pipeline para o ambiente afetado.

Causa

O pipeline de implantação falha porque o pacote de aplicativo personalizado não importa os pacotes Apache Tika necessários, resultando em erros de carregamento de classe durante a inicialização do serviço.

Resolução resolution

Para corrigir a falha de implantação causada pela falta de importações de pacotes Apache Tika, siga estas etapas:

  1. Edite a seção Import-Package do pacote afetado para importar explicitamente todos os pacotes org.apache.tika.* necessários, como org.apache.tika.io.

  2. Exemplo (em bnd.bnd ou equivalente):

    Import-Package: org.apache.tika.io, org.apache.tika.*

  3. Certifique-se de que o pacote não incorpore sua própria versão do Apache Tika. Conte com os pacotes Tika fornecidos pela plataforma para evitar conflitos de versão.

  4. Confirme e implante o pacote atualizado por meio do pipeline do Cloud Manager.

  5. No Console da Web do AEM, verifique se o pacote personalizado está listado como um pacote de importação para org.apache.tika.core.

  6. Confirme se nenhum NoClassDefFoundError ou ClassNotFoundException para as classes Tika aparecem nos logs.

  7. Valide se a extração do PDF e os serviços relacionados são iniciados sem erros da Estrutura OSGi.

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