文件Experience Cloud KCS

在AEM環境中安裝套件失敗

最後更新： 2026年7月16日

當套件包含不可變路徑、無效的ZIP結構、安裝掛接或受影響的AEM版本時，SDK套件安裝會失敗。 診斷安裝錯誤，並依照適當的解決步驟順利安裝套件。

說明 description

環境

  • Adobe Experience Manager as a Cloud Service
  • AEM Managed Services
  • Adobe Developer App Builder

問題/症狀

  • 上傳期間發生錯誤，指出封存不是有效的內容套件，因為缺少jcr_root。
  • 安裝期間發生套件驗證錯誤。
  • 安裝遭到封鎖，因為套件包含不可變的存放庫路徑。
  • 所有套件中的內巢狀件不會自動安裝。
  • 封裝名稱無效導致封裝下載失敗。
  • 與缺少安裝掛接類別相關的安裝失敗。

原因

當套件結構無效、套件包含不可變的存放庫路徑、套件名稱包含不支援的字元、在不支援的情況下使用安裝掛接，或部署仰賴受回歸影響的SDK版本時，就會發生安裝失敗。

解決方法 resolution

若要解決此問題，請遵循下列步驟：

  1. 檢閱封裝管理員訊息或記錄以識別安裝錯誤。
  2. 如果封裝無法辨識為內容封裝，請確認META-INF和jcr_root存在於ZIP檔案的最上層。 如有必要，請重新建立套件。
  3. 如果套件包含不可變的存放庫路徑，請透過適當的部署管道部署程式碼，而非直接透過套件管理器安裝。
  4. 如果內巢狀件未自動安裝，請驗證SDK版本，並升級至包含回歸修正的SDK版本。
  5. 部署至不支援安裝的環境時，請移除安裝鉤點。 對於支援的環境，請確定已安裝所有必要的相依性。
  6. 更新套件名稱以移除不支援的字元，並在再次部署之前重新建置套件。
  7. 確認安裝錯誤不再出現，且內巢狀件已正確安裝（如適用），以驗證安裝。

相關閱讀

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