AEM Sites環境中的作者模式錯誤處理差異

在較低的環境中,元件層級失敗會內嵌顯示,讓頁面的其餘部分都可呈現。 在更高的環境中,類似的錯誤會導致整個頁面無法呈現。

說明 description

在Adobe Experience Manager Sites中,相同頁面會根據環境在作者模式下顯示不同的錯誤處理行為。 在較低的環境中,元件層級失敗會內嵌顯示,讓頁面的其餘部分都可呈現。 在較高層級的環境中,類似的錯誤會導致整個頁面無法呈現或變得無法撰寫,即使不同環境的程式碼基底都相同。

環境

Adobe Experience Manager as a Cloud Service (所有版本)

症狀

  • 在較低的環境中,元件錯誤會內嵌顯示,而頁面會繼續載入。
  • 在較高層級的環境中,相同的錯誤會導致頁面在製作模式中完全失敗。
  • 根本原因通常是缺少元件類別參考,這會在每個環境中擲回例外狀況,但產生的使用者體驗不同。

原因

此差異是因為WCMDeveloperModeFilter的預設設定。 此篩選器在較低環境中啟用,在較高環境中停用。 啟用後,它會擷取元件例外狀況,並允許頁面轉譯為內嵌錯誤訊息。 停用時,元件例外會導致整個頁面失敗。

解決方法 resolution

請依照下列步驟解決問題。

  1. 瞭解WCMDeveloperModeFilter行為:在較低的環境中,WCMDeveloperModeFilter預設為啟用。 它會擷取元件例外狀況,並顯示內嵌錯誤訊息,以便呈現頁面的其餘部分。 在較高層級的環境中,篩選器預設為停用,因此元件例外會導致整個頁面失敗。
  2. 請勿在較低層環境中停用開發人員模式: Adobe建議在較低層環境中啟用開發人員模式,以協助在程式碼提升至較高層環境之前識別和修正元件錯誤。 在較低層環境中停用開發人員模式可能會隱藏元件層級失敗,導致較難及早偵測問題。
  3. 檢查開發人員模式狀態:檢閱您環境中的com.day.cq.wcm.core.impl.WCMDeveloperModeFilter設定。 組態檔通常名為com.day.cq.wcm.core.impl.WCMDeveloperModeFilter.cfg.json。 屬性enabled應設為false以停用篩選。 如果檔案不存在或enabled未設定為false,則較低層環境中預設會啟用開發人員模式。
  4. 使用AEM編輯器側面板中的 錯誤 索引標籤來檢視元件層級問題。 只有管理員群組的成員可以存取開發人員模式。
  5. 依照最佳做法的要求,開發人員應在較低層級環境中使用開發人員模式,以在將程式碼提升至較高層級環境之前識別並解決元件錯誤。

變更設定後,請在每個受影響的製作環境中測試具有已知元件錯誤的頁面,以確認預期的錯誤處理行為。

相關閱讀

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