DocumentazioneExperience Cloud KCS

L’implementazione di AEM Cloud Manager non riesce a causa di importazioni mancanti del pacchetto Apache Tika

Ultimo aggiornamento: 11 agosto 2026

Questo articolo descrive come risolvere gli errori della pipeline di distribuzione negli ambienti Adobe Experience Manager Cloud Manager causati da importazioni mancanti del pacchetto Apache Tika nei bundle di applicazioni personalizzate.

Descrizione description

Ambiente

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

Problema/Sintomi

  • La pipeline di distribuzione non riesce nell’ambiente di controllo qualità durante il passaggio di distribuzione.

  • Tutti i passaggi della pipeline precedenti (build, qualità del codice, build dell’immagine, processo di trasformazione e aggiornamenti dell’indice) sono stati completati correttamente.

  • La distribuzione non riesce e viene visualizzato un errore che indica che i contenitori non sono pronti.

  • I registri di pubblicazione di AEM mostrano ripetuti errori del framework OSGi relativi alla funzionalità di estrazione di PDF, ad esempio:

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

  • I bundle Apache Tika forniti dalla piattaforma (org.apache.tika.core, org.apache.tika.parsers) sono presenti e attivi.

  • Il bundle dell’applicazione personalizzata non importa i pacchetti org.apache.tika.* richiesti, causando errori di caricamento delle classi quando si fa riferimento alle classi Tika.

  • Il problema è riproducibile su ogni esecuzione della pipeline per l’ambiente interessato.

Causa

La pipeline di distribuzione non riesce perché il bundle dell’applicazione personalizzata non importa i pacchetti Apache Tika richiesti, generando errori di caricamento delle classi durante l’avvio del servizio.

Risoluzione resolution

Per risolvere l’errore di distribuzione causato da importazioni mancanti del pacchetto Apache Tika, effettua le seguenti operazioni:

  1. Modificare la sezione Import-Package del bundle interessato per importare in modo esplicito tutti i org.apache.tika.* pacchetti richiesti, ad esempio org.apache.tika.io.

  2. Esempio in bnd.bnd o equivalente:

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

  3. Assicurati che il bundle non incorpori la propria versione di Apache Tika. Utilizza i bundle Tika forniti dalla piattaforma per evitare conflitti di versioni.

  4. Esegui il commit e distribuisci il bundle aggiornato tramite la pipeline Cloud Manager.

  5. Nella console Web AEM verificare che il bundle personalizzato sia elencato come bundle di importazione per org.apache.tika.core.

  6. Verificare che nei registri non siano presenti NoClassDefFoundError o ClassNotFoundException classi Tika.

  7. Verifica che l’estrazione di PDF e dei servizi correlati venga avviata senza errori del framework OSGi.

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