文件Experience Cloud KCS

自訂轉盤元件中格式錯誤的頁面導致AEM作者預覽404錯誤

最後更新： 2026年8月24日

本文說明當自訂轉盤元件參考格式錯誤或空白頁面時，如何解決Adobe Experience Manager (AEM)作者預覽中的404錯誤，進而導致轉譯失敗。

說明 description

環境

  • Adobe Experience Manager (AEM)作者
  • 使用Sling模型的自訂轉盤元件

問題/症狀

  • 在AEM Author中預覽包含自訂轉盤元件的頁面會導致404錯誤。
  • 當輪播參考格式錯誤或空白頁面時，就會發生錯誤。

原因

由於轉盤元件使用的自訂Sling模型發生NullPointerException，因此會發生問題。 模型不會處理遺失或無效的頁面。 如果參照的頁面在預期路徑下沒有子節點或內容，元件將無法轉譯並傳回404回應。

解決方法 resolution

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

  1. 檢閱AEM網站中自訂轉盤元件參考的頁面清單。
  2. 識別空白、格式錯誤或預期路徑下缺少必要內容的頁面。
  3. 移除或修正存放庫中的任何無效或空白頁面。
  4. 更新自訂轉盤元件程式碼，以正常處理遺失或格式錯誤的頁面。
  5. 確保元件略過無效的專案而非導致失敗。
  6. 在AEM作者預覽中測試受影響的頁面，確認404錯誤不再發生，且轉盤會如預期般轉譯。
recommendation-more-help
experience-cloud-kcs-help-kbarticles