在AEM Cloud Manager中部署期間的OSGi套件解析失敗

在Adobe Experience Manager (AEM) Cloud Manager中,部署期間的OSGi套件解析失敗會讓套件組合停用或未解決,並導致服務和功能無法使用。 部署後,當必要的OSGi套件或套件組合遺失、非作用中或不相容時,就會發生問題。 若要修正此問題,請識別未解決的相依性,並將所需的套件組合、套件和程式碼與部署的AEM環境對齊。

說明 description

環境

  • Adobe Experience Manager (AEM) Cloud Manager

症狀

  • 在Cloud Manager中的OSGi套件組合解析階段期間,部署失敗。

  • 多個OSGi組合(例如Granite UI、DAM、Campaign和Forms)保持非作用中或未解決。

  • 錯誤記錄檔會顯示封裝的未解析需求,例如:

    org.apache.sling.scripting.jsp.util

    com.adobe.aem.dermis.api.bridge

  • 遺失類別的錯誤,例如ClassNotFoundException。

  • 排定的工作可能失敗,復寫測試Ping可能傳回Connection refused。

  • AEM執行個體在部署後可能會停止回應。

原因

部署因OSGi套件相依性未解析而失敗,通常是因為不相容或缺少套件組合、升級不完整或AEM基底、附加元件和自訂程式碼之間的套件對齊方式不當所導致。

解決方法 resolution

請依照下列步驟解決問題:

  1. 暫停進一步的部署嘗試,直到執行階段和套件狀態通過驗證為止。

  2. 請檢閱AEM error.log以瞭解未解析的OSGi套件需求,並識別哪些套件組合非作用中或未解析。

  3. 比較失敗的部署與上次的已知良好部署:

    1. 使用AEM Web主控台(系統主控台>套裝)檢查已安裝的套件和套裝版本。
    2. 確認必要的組合(例如提供org.apache.sling.scripting.jsp.util的組合)存在且處於Active狀態。
    3. 確認所有核心AEM、DAM、Campaign和Forms套件組合皆為作用中。
  4. 確認AEM基本版本、Forms附加元件、Service Pack和任何適用的Hotfix相容且已正確安裝。

  5. 如果最近的升級或部署變更了執行階段狀態,請使用標準部署程式(例如,使用Cloud Manager或封裝管理員)還原或重新部署最後一個已知良好的成品。

  6. 修正後,執行受控部署:

    • 分別依序部署核心套件組合和內容套件,以將風險降至最低。
    • 避免在單一步驟中將所有自訂套件組合和內容套件部署在一起。
  7. 部署後,請確認:

    • 提供org.apache.sling.scripting.jsp.util的組合存在且作用中。
    • com.adobe.granite.ui.commons和其他受影響的組合作用中。
    • OSGi Web主控台中不會保留任何無法解析的套件匯入。
    • AEM和受影響的功能(例如Forms)會通過煙霧測試並回應。
  8. 如果修復後未解決的套件組合持續存在,請計畫完整執行個體重新啟動以重新整理OSGi配線。

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