文件Experience Cloud KCS

由於作業系統或相依性不符，導致AEM Dispatcher安裝和升級失敗

最後更新： 2026年6月22日

Adobe Experience Manager (AEM) Dispatcher安裝或升級在Apache未啟動、模組未載入，或作業系統、OpenSSL或架構更新後的相依性不相符時失敗。 此問題發生的原因是不相容的Dispatcher二進位檔與系統程式庫、不正確的模組選擇或在環境升級期間不支援的架構。 若要解決此問題，請選取正確的二進位檔、驗證相依性，並對齊設定。

說明 description

環境

Adobe Experience Manager as a Cloud Service (AEMaaCS)

問題/症狀

  • 升級後，Apache無法啟動，因為缺少libssl或libcrypto相依性。
  • 由於架構不相容，Dispatcher模組未正確載入或載入。
  • 在OpenSSL版本（例如1.1到3.0）之間移轉時，環境會顯示錯誤。
  • 系統顯示RHEL 8、RHEL 9或Amazon Linux 2023等支援作業系統版本的不確定性或不相符。

根本原因

當Dispatcher模組因取決於特定CPU架構、OpenSSL版本、Apache組建和作業系統層級程式庫而不符合系統環境時，就會發生問題。 當環境升級或變更時，由於相依性不相符、不正確的二進位選擇或舊版中不支援的架構（例如ARM64），現有模組無法載入。

解決方法 resolution

請依照下列步驟識別環境，並安裝相容的Dispatcher模組。

  1. 使用系統命令檢查作業系統、Apache、CPU架構和OpenSSL版本，以識別作業環境。
  2. 根據OpenSSL版本、作業系統和架構（例如ssl1.1、ssl3.0或ARM64支援的版本）選取二進位檔案，以判斷正確的Dispatcher套件。
  3. 在伺服器上下載並解壓縮Dispatcher套件，並確認在解壓縮後模組檔案可供使用。
  4. 將Dispatcher模組檔案複製到Apache模組目錄，並確認該檔案位於正確位置。
  5. 使用正確的模組路徑新增Dispatcher LoadModule指示詞，以更新Apache設定。
  6. 透過檢查所有必要的程式庫是否存在並符合OpenSSL版本來驗證模組相依性。
  7. 重新啟動Apache，並確認Dispatcher模組成功載入且沒有啟動錯誤。
  8. 升級後清除Dispatcher快取，以確保新資產正確載入並避免過時內容問題。
  9. 透過執行設定檢查、驗證記錄、傳送測試請求及確認成功的模組初始化和快取行為來驗證解決方案。

何時上報

  • 即使解決相依性和設定問題，Apache服務也無法啟動。
  • Dispatcher模組已載入，但還是顯示相依性或相容性錯誤。
  • 目標作業系統或架構不存在必要的Dispatcher套件。
  • 此環境需要不受支援的設定，例如ARM64的較舊Dispatcher版本。

相關閱讀

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