文件Experience Cloud KCS

使用深度巢狀內容片段發佈頁面

最後更新： 2026年8月1日

本文說明如何解決參考深層巢狀內容片段的AEM Sites頁面在遞回參考搜尋程式期間逾時而無法發佈的情況。

說明 description

環境

Adobe Experience Manager as a Cloud Service （所有版本）

問題/症狀

發佈參照具有深層或寬巢狀參照之內容片段的AEM Sites頁面時，該頁面不會出現在管理發布裝載中，且不會發佈。 當內容片段參考許多其他內容片段，導致數千個巢狀參考和多個巢狀層級時，就會發生這種情況。 參考檢查程式會變得緩慢且可能逾時，使頁面無法包含在發佈工作流程中。 UI中未出現任何明確的錯誤訊息，但發佈裝載中缺少預期的頁面。

原因

深層巢狀內容片段的遞回參考搜尋可能會導致效能降低和逾時，使頁面無法包含在發佈裝載中。 停用遞回搜尋可改善效能，但需要手動管理巢狀片段發佈。

解決方法 resolution

若要修正參考深層巢狀內容片段的AEM Sites頁面無法發佈的問題，請執行下列步驟：

  1. 更新com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl的組態並設定停用遞回內容片段參考搜尋的選項，以停用遞回內容片段參考搜尋。

  2. 透過Cloud Manager更新設定：

    • 在您的Cloud Manager專案中，新增或更新com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl的OSGi設定檔。
    • 在組態中設定"enable.recursive.cf.reference.search": false。
    • 透過您的Cloud Manager管道提交和部署設定。

  3. 或者，在本機或非生產環境中透過OSGi控制檯更新設定：

    • 登入AEM Author例項。
    • 瀏覽至/system/console/configMgr。
    • 搜尋ActivationReferenceSearchServiceImpl。
    • 編輯設定並將遞回內容片段參考搜尋設定為false。
    • 儲存設定。

  4. 停用遞回搜尋後，嘗試使用管理發布再次發佈受影響的頁面。 該頁面現在應包含在發佈裝載中，並成功發佈。

  5. 視需要手動發佈深度巢狀內容片段。 停用遞回搜尋時，只會自動解析第一層參照。 確保所有必要的巢狀內容片段已發佈，方法是透過CF/Assets主控台手動發佈，或在發佈程式中包含相關CF資料夾。

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