DocumentazioneExperience Cloud KCS

Errori di risoluzione del bundle OSGi durante la distribuzione in AEM Cloud Manager

Ultimo aggiornamento: 12 ottobre 2026

In Adobe Experience Manager (AEM) Cloud Manager, gli errori di risoluzione del bundle OSGi durante la distribuzione possono lasciare i bundle inattivi o non risolti e causare la mancata disponibilità di servizi e funzionalità. Il problema si verifica quando i pacchetti OSGi o i bundle richiesti risultano mancanti, inattivi o incompatibili dopo la distribuzione. Per risolvere questo problema, identifica le dipendenze non risolte e allinea i bundle, i pacchetti e il codice richiesti con l’ambiente AEM implementato.

Descrizione description

Ambiente

  • Adobe Experience Manager (AEM) Cloud Manager

Sintomi

  • L’implementazione non riesce durante la fase di risoluzione del bundle OSGi in Cloud Manager.

  • Più bundle OSGi (come l’interfaccia utente Granite, DAM, Campaign e Forms) rimangono inattivi o non risolti.

  • I registri di errore mostrano i requisiti non risolti per i pacchetti, ad esempio:

    org.apache.sling.scripting.jsp.util

    com.adobe.aem.dermis.api.bridge

  • Errori come ClassNotFoundException per le classi mancanti.

  • I processi pianificati potrebbero non riuscire e i ping del test di replica potrebbero restituire Connection refused.

  • L’istanza di AEM potrebbe non rispondere dopo la distribuzione.

Causa

La distribuzione non riesce a causa di dipendenze non risolte del pacchetto OSGi, spesso dovute a bundle incompatibili o mancanti, aggiornamenti incompleti o un allineamento non corretto del pacchetto tra la base AEM, i componenti aggiuntivi e il codice personalizzato.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Sospendi ulteriori tentativi di distribuzione fino alla convalida del runtime e dello stato del pacchetto.

  2. Esamina il registro degli errori di AEM per i requisiti del pacchetto OSGi non risolti e identifica quali bundle sono inattivi o non risolti.

  3. Confrontare la distribuzione non riuscita con l’ultima distribuzione valida:

    1. Verificare le versioni del pacchetto e del bundle installate utilizzando la console Web di AEM (bundle della console di sistema >).
    2. Verificare che i bundle richiesti (ad esempio quello che fornisce org.apache.sling.scripting.jsp.util) siano presenti e nello stato Active.
    3. Assicurati che tutti i bundle core AEM, DAM, Campaign e Forms siano attivi.

  4. Verifica che la versione base di AEM, il componente aggiuntivo Forms, il service pack ed eventuali aggiornamenti rapidi applicabili siano compatibili e installati correttamente.

  5. Se un aggiornamento o una distribuzione recente ha modificato lo stato di runtime, ripristinare o ridistribuire l’ultimo artefatto valido noto utilizzando il processo di distribuzione standard (ad esempio, utilizzando Cloud Manager o Gestione pacchetti).

  6. Dopo la correzione, eseguire una distribuzione controllata:

    • Distribuisci i bundle core e i pacchetti di contenuti separatamente e in sequenza per ridurre al minimo i rischi.
    • Evita di distribuire tutti i bundle personalizzati e i pacchetti di contenuti insieme in un singolo passaggio.

  7. Dopo la distribuzione, verifica che:

    • Il bundle che fornisce org.apache.sling.scripting.jsp.util è presente e attivo.
    • com.adobe.granite.ui.commons e altri bundle interessati sono attivi.
    • Nella console web OSGi non rimane alcuna importazione di pacchetti non risolta.
    • AEM e le funzioni interessate (come Forms) superano i test di fumo e sono reattive.

  8. Se i bundle non risolti persistono dopo la correzione, pianifica un riavvio completo dell’istanza per aggiornare il cablaggio OSGi.

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