解決由於OSGi套件不一致而導致單一AEM發佈執行個體發生HTTP 500錯誤的問題
本文說明如何解決單一Adobe Experience Manager (AEM)發佈執行個體上,在OSGi套件組合在異常或不乾淨重新啟動後無法解析和正確啟用時發生的HTTP 500錯誤。
說明 description
環境
Adobe Experience Manager (AEM) Managed Services多執行個體發佈部署(所有支援的版本)
問題/症狀
- 一個發佈執行個體傳回多個應用程式URL中的大量HTTP
500錯誤。 - 其他發佈執行個體可繼續正常提供流量。
- 應用程式記錄會顯示重複的HTL/Sightly編譯失敗,因為無法解析Java類別。
- OSGi框架會記錄報告套裝解析度錯誤,以及所需應用程式套裝的未解析相依性。
原因
異常或不乾淨的重新啟動會讓受影響發佈執行個體上的OSGi框架處於不一致的狀態。 必要的應用程式套件組合無法解析和啟動。 因此,無法使用HTL編譯所需的類別,且受影響應用程式URL的請求會傳回HTTP 500錯誤。
解決方法 resolution
請依照下列步驟解決問題。
-
從負載平衡器循環中移除受影響的發佈執行個體,以防止進一步影響客戶。
-
使用乾淨且受控制的程式重新啟動或取代受影響的發佈執行個體。
-
重新啟動或取代執行個體後,請確認所有必要的OSGi套件組合均已解析且作用中:
-
存取AEM系統主控台(通常在
/system/console/bundles),並檢查所有套件組合是否都處於 作用中 狀態。 -
確認應用程式頁面成功轉譯且沒有編譯錯誤。
-
監控錯誤記錄檔,瞭解任何進一步的套件組合解析或HTL編譯錯誤。
-
-
作為一項預防措施,在每次計畫內或計畫外重新啟動後實施準備情況檢查,以確保所有套件組合在讓執行個體返回服務之前均為作用中。
recommendation-more-help
experience-cloud-kcs-help-kbarticles