解決AEM Package Manager上傳/存取失敗(許可權、網路、URL和執行階段限制)
當套件未出現、存取遭到封鎖,或安裝傳回未定義的訊息時,「套件管理員」的上傳或安裝可能會失敗。
您可能無法開啟封裝管理員、上傳封裝、檢視上傳的封裝,或完成安裝。 在某些情況下,上傳似乎已完成,但封裝未出現在清單中。 在雲端環境中,當套件包含執行階段不支援的不可變內容時,安裝也會失敗。
常見原因包括缺少許可權、URL不正確、網路限制、瀏覽器干擾以及包含雲端環境中不可變路徑的套件。 確認存取路徑、測試許可權和瀏覽器行為,並檢閱套件篩選器以找出不支援的內容。 僅針對可變內容使用執行階段套件安裝,並透過部署管道部署不可變內容。
說明 description
環境:
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Experience Manager內部部署
問題/症狀:
- 如果無法在
/crx/packmgr存取封裝管理員,請開啟目標環境的正確封裝管理員URL,並確認/crx/packmgr/index.jsp載入時不會重新導向或存取錯誤。 - 如果「封裝管理員」中未顯示任何封裝,請檢查具有預期存取權的其他使用者是否可以檢視或上傳封裝,以判斷此問題是否與許可權相關。
- 如果封裝上傳完成,但封裝未出現在「封裝管理員」中,請重新整理介面,並使用小型測試封裝重試,以確認是否接受上傳且正確顯示。
- 如果上傳失敗且沒有清除錯誤,請從其他網路重試相同的動作,以在請求到達AEM之前判斷防火牆或Proxy限制是否阻止請求。
- 如果瀏覽器在安裝期間顯示未定義的錯誤,請在無痕工作階段或不同的支援瀏覽器中重複此動作,以排除延伸、工作階段或瀏覽器特有的干擾。
- 如果雲端環境因套件包含不支援的執行階段內容而拒絕該套件,請檢閱套件篩選器,並確認套件僅包含執行階段安裝所需的可變內容,且不包含不可變路徑,例如
/apps。
根本原因:
這些失敗通常是由封裝路徑上缺少許可權、不正確的封裝管理員URL、網路或防火牆限制、干擾請求的瀏覽器擴充功能或工作階段行為、封鎖上傳的本機安全性工具,或包含雲端環境中不可變路徑(例如/apps)的封裝篩選器所導致。
解決方法 resolution
請嘗試下列步驟:
- 開啟目標環境的正確封裝管理員URL,並確認
/crx/packmgr/index.jsp載入時不會重新導向或存取錯誤。 - 將結果與預期具有相同存取層級的另一個使用者進行比較,檢查受影響的使用者是否具有建立、上傳、檢視及安裝套裝軟體的許可權。
- 如果封裝管理員未開啟或上傳未啟動,請從不同的網路重試相同的動作,以判斷防火牆或Proxy限制是否封鎖要求。
- 如果瀏覽器中的上載或安裝失敗,請在無痕工作階段或其他支援的瀏覽器中重複此動作,以排除擴充功能、工作階段或瀏覽器特有的干擾。
- 如果目標環境和本機SDK中的相同上傳失敗,請檢閱本機或組織安全性控制,因為請求可能會在到達AEM之前遭到封鎖。
- 對於雲端環境,請檢閱套件篩選器,並確認套件僅包含用於執行階段安裝的可變內容,不包含不可變路徑,例如
/apps。 - 如果封裝包含不可變內容,請透過部署管道(而不是封裝管理員)部署該內容。
- 進行變更後,請上傳小型測試套件、重新整理「套件管理員」,並確認套件出現在清單中且安裝時沒有新錯誤。
如果問題在這些檢查後繼續,則在多個瀏覽器中上傳失敗時向Adobe支援提交票證,所有使用者都無法存取封裝管理員,在受影響的使用者無法存取時,具有類似存取許可權的其他使用者可以完成動作,或者測試顯示請求未送達AEM。 包含熒幕擷取畫面、HAR檔案、瀏覽器主控台記錄、套件名稱和疑難排解結果摘要。
experience-cloud-kcs-help-kbarticles