DocumentationExperience Cloud KCS

Le déploiement d’AEM Cloud Manager échoue en raison d’importations de package Apache Tika manquantes

Dernière mise à jour : 11 août 2026

Cet article décrit comment résoudre les échecs du pipeline de déploiement dans les environnements Adobe Experience Manager Cloud Manager, causés par l’absence d’importations de packages Apache Tika dans les lots d’applications personnalisées.

Description description

Environnement

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

Problème/Symptômes

  • Le pipeline de déploiement échoue dans l’environnement d’assurance qualité lors de l’étape de déploiement.

  • Toutes les étapes précédentes du pipeline (création, qualité du code, création d’image, tâche de transformation et mises à jour de l’index) se sont terminées avec succès.

  • Le déploiement échoue avec une erreur indiquant que les conteneurs ne sont pas prêts.

  • Les journaux de publication AEM affichent des erreurs OSGi Framework répétées liées à la fonctionnalité d’extraction PDF, telles que :

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

  • Les lots Apache Tika fournis par la plateforme (org.apache.tika.core, org.apache.tika.parsers) sont présents et actifs.

  • Le lot d’applications personnalisées n’importe pas les packages org.apache.tika.* requis, ce qui entraîne des échecs de chargement de classe lors du référencement de classes Tika.

  • Le problème est reproductible à chaque exécution de pipeline pour l’environnement affecté.

Cause

Le pipeline de déploiement échoue, car le lot d’applications personnalisées n’importe pas les packages Apache Tika requis, ce qui entraîne des erreurs de chargement de classe lors du démarrage du service.

Résolution resolution

Pour résoudre l’échec de déploiement dû à l’absence d’importation du package Apache Tika, procédez comme suit :

  1. Modifiez la section Import-Package du lot concerné pour importer explicitement tous les packages org.apache.tika.* requis, tels que org.apache.tika.io.

  2. Exemple (en bnd.bnd ou équivalent) :

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

  3. Assurez-vous que le lot n’incorpore pas sa propre version d’Apache Tika. Utilisez les lots Tika fournis par la plateforme pour éviter les conflits de version.

  4. Validez et déployez le lot mis à jour via le pipeline Cloud Manager.

  5. Dans la console web AEM, vérifiez que le lot personnalisé est répertorié comme lot d’importation pour org.apache.tika.core.

  6. Vérifiez qu’aucun NoClassDefFoundError ou ClassNotFoundException pour les classes Tika n’apparaît dans les journaux.

  7. Vérifiez que l’extraction PDF et les services associés démarrent sans erreurs de framework OSGi.

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