DokumentationExperience Cloud KCS

Fehler bei der OSGi-Bundle-Auflösung während der Bereitstellung in AEM Cloud Manager

Letzte Aktualisierung: 12. Oktober 2026

In Adobe Experience Manager (AEM) Cloud Manager können Fehler bei der Auflösung von OSGi-Bundles während der Bereitstellung dazu führen, dass Bundles inaktiv oder ungelöst bleiben und Services und Funktionen nicht mehr verfügbar sind. Das Problem tritt auf, wenn erforderliche OSGi-Pakete oder -Bundles nach der Bereitstellung fehlen, inaktiv oder inkompatibel sind. Um dieses Problem zu beheben, identifizieren Sie nicht gelöste Abhängigkeiten und richten Sie die erforderlichen Bundles, Pakete und den Code an der bereitgestellten AEM-Umgebung aus.

Beschreibung description

Umgebung

  • Adobe Experience Manager (AEM) Cloud Manager

Symptome

  • Die Bereitstellung schlägt während der Phase der OSGi-Bundle-Auflösung in Cloud Manager fehl.

  • Mehrere OSGi-Bundles (z. B. Granite-Benutzeroberfläche, DAM, Campaign und Forms) bleiben inaktiv oder ungelöst.

  • Fehlerprotokolle zeigen ungelöste Anforderungen für Pakete an, z. B.:

    org.apache.sling.scripting.jsp.util

    com.adobe.aem.dermis.api.bridge

  • Fehler wie ClassNotFoundException für fehlende Klassen.

  • Geplante Aufträge können fehlschlagen, und die Pings für den Replikationstest können Connection refused zurückgeben.

  • Die AEM-Instanz reagiert nach der Bereitstellung möglicherweise nicht mehr.

Ursache

Die Bereitstellung schlägt aufgrund nicht aufgelöster OSGi-Paketabhängigkeiten fehl, häufig aufgrund inkompatibler oder fehlender Bundles, unvollständiger Upgrades oder falscher Paketausrichtung zwischen der AEM-Basis, Add-ons und benutzerdefiniertem Code.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Anhalten weiterer Bereitstellungsversuche, bis der Laufzeit- und Paketstatus validiert wurden.

  2. Überprüfen Sie die Datei error.log von AEM auf nicht aufgelöste OSGi-Paketanforderungen und ermitteln Sie, welche Pakete inaktiv oder ungelöst sind.

  3. Vergleich der fehlgeschlagenen Bereitstellung mit der letzten zweifelsfrei funktionierenden Bereitstellung:

    1. Überprüfen Sie die installierten Paket- und Bundle-Versionen mithilfe der AEM Web Console (System Console > Bundles).
    2. Überprüfen Sie, ob die erforderlichen Bundles (z. B. das org.apache.sling.scripting.jsp.util bereitstellende Bundle) vorhanden sind und sich im Active befinden.
    3. Stellen Sie sicher, dass alle Kern-Bundles von AEM, DAM, Campaign und Forms aktiv sind.

  4. Vergewissern Sie sich, dass die AEM-Basisversion, das Forms-Add-on, das Service Pack und alle zutreffenden Hotfixes kompatibel und korrekt installiert sind.

  5. Wenn ein kürzlich durchgeführtes Upgrade oder eine kürzlich durchgeführte Bereitstellung den Laufzeitstatus geändert haben, stellen Sie das letzte zweifelsfrei funktionierende Artefakt mithilfe Ihres Standardbereitstellungsprozesses wieder her oder stellen Sie es erneut bereit (z. B. mit Cloud Manager oder Package Manager).

  6. Führen Sie nach der Behebung eine kontrollierte Bereitstellung durch:

    • Bereitstellen von Kern-Bundles und Inhaltspaketen separat und nacheinander, um Risiken zu minimieren.
    • Vermeiden Sie es, alle benutzerdefinierten Bundles und Inhaltspakete in einem Schritt bereitzustellen.

  7. Überprüfen Sie nach der Bereitstellung Folgendes:

    • Das org.apache.sling.scripting.jsp.util bereitstellende Bundle ist vorhanden und aktiv.
    • com.adobe.granite.ui.commons und andere betroffene Bundles sind aktiv.
    • In der OSGi-Web-Konsole bleiben keine ungelösten Paketimporte übrig.
    • AEM und die betroffenen Funktionen (z. B. Forms) bestehen Feuerproben und sind responsiv.

  8. Wenn nicht aufgelöste Bundles nach der Behebung bestehen bleiben, planen Sie einen vollständigen Neustart der Instanz ein, um die OSGi-Verkabelung zu aktualisieren.

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