DocumentationExperience Cloud KCS

Échecs de résolution de bundle OSGi lors du déploiement dans AEM Cloud Manager

Dernière mise à jour : 12 octobre 2026

Dans Adobe Experience Manager (AEM) Cloud Manager, les échecs de résolution de bundles OSGi pendant le déploiement peuvent laisser les bundles inactifs ou non résolus et entraîner l’indisponibilité des services et fonctionnalités. Le problème se produit lorsque les packages ou lots OSGi requis sont manquants, inactifs ou incompatibles après le déploiement. Pour résoudre ce problème, identifiez les dépendances non résolues et alignez les lots, les packages et le code requis sur l’environnement AEM déployé.

Description description

Environnement

  • Adobe Experience Manager (AEM) Cloud Manager

Symptômes

  • Le déploiement échoue lors de la phase de résolution du bundle OSGi dans Cloud Manager.

  • Plusieurs lots OSGi (tels que l’IU Granite, la gestion des ressources numériques, Campaign et Forms) restent inactifs ou non résolus.

  • Les journaux d’erreurs affichent les exigences non résolues pour les packages, par exemple :

    org.apache.sling.scripting.jsp.util

    com.adobe.aem.dermis.api.bridge

  • Erreurs telles que ClassNotFoundException pour les classes manquantes.

  • Les tâches planifiées peuvent échouer et les pings de test de réplication peuvent revenir Connection refused.

  • L’instance AEM risque de ne plus répondre après le déploiement.

Cause

Le déploiement échoue en raison de dépendances de package OSGi non résolues, souvent résultant de lots incompatibles ou manquants, de mises à niveau incomplètes ou d’un alignement incorrect du package entre la base d’AEM, les modules complémentaires et le code personnalisé.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Suspendre les tentatives de déploiement supplémentaires jusqu’à ce que l’exécution et l’état du package soient validés.

  2. Consultez le fichier error.log d’AEM pour connaître les exigences non résolues du package OSGi et identifier les lots inactifs ou non résolus.

  3. Comparez le déploiement ayant échoué au dernier déploiement, dont le fonctionnement a été vérifié :

    1. Vérifiez les versions de package et de bundle installées à l’aide de la console web AEM (console système > bundles).
    2. Vérifiez que les lots requis (par exemple celui qui fournit org.apache.sling.scripting.jsp.util) sont présents et qu’ils sont à l’état Active.
    3. Assurez-vous que tous les lots principaux d’AEM, de gestion des ressources numériques, de Campaign et de Forms sont actifs.

  4. Vérifiez que la version de base d’AEM, le module complémentaire Forms, le pack de services et les correctifs applicables sont compatibles et correctement installés.

  5. Si une mise à niveau ou un déploiement récent a modifié l’état d’exécution, restaurez ou redéployez le dernier artefact, dont le fonctionnement a été vérifié, à l’aide de votre processus de déploiement standard (par exemple, à l’aide de Cloud Manager ou du gestionnaire de packages).

  6. Après la remédiation, effectuez un déploiement contrôlé :

    • Déployez les lots principaux et les packages de contenu séparément et séquentiellement afin de minimiser les risques.
    • Évitez de déployer tous les lots et packages de contenu personnalisés en une seule étape.

  7. Après le déploiement, vérifiez les éléments suivants :

    • Le lot qui fournit la org.apache.sling.scripting.jsp.util est présent et actif.
    • com.adobe.granite.ui.commons et les autres lots affectés sont actifs.
    • Il ne reste aucune importation de package non résolue dans la console web OSGi.
    • AEM et les fonctionnalités affectées (telles que Forms) réussissent les tests de vérification et sont réactifs.

  8. Si des lots non résolus persistent après la correction, prévoyez un redémarrage complet de l’instance pour actualiser le câblage OSGi.

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