文件Experience Cloud KCS

在作者中進行更新後，AEM預覽環境中缺少選件元件

最後更新： 2026年8月30日

在Adobe Experience Manager (AEM)中，您在Author中新增或更新的Offer元件不會出現在預覽環境中。 問題通常會影響特定頁面，而其他頁面則會繼續如預期顯示更新的內容。 不會出現任何錯誤訊息，但預覽會顯示遺失或過時的選件元件，這會影響發佈前的內容驗證。 若要修正此問題，請驗證頁面內容和API回應，勾選「預覽」或「後端對前端」快取，然後重新發佈受影響的頁面。

說明 description

環境

  • Adobe Experience Manager (AEM)，所有版本
  • 解耦/無周邊預覽環境（例如使用AEM API的自訂前端應用程式）

問題/症狀

  • 更新的或新的優惠方案元件會顯示在AEM Author中，但不會顯示在預覽環境中。
  • 其他頁面可能會如預期更新；此問題特定於某些頁面。
  • 未顯示明確的錯誤訊息。

原因

最常見的原因是預覽環境或其前端對前(BFF)層中的快取，這可能提供過期的API回應。 這通常不是AEM作者或發佈復寫問題。

解決方法 resolution

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

  1. 確認所有預期選件元件皆存在於AEM製作環境中並發佈。
  2. 使用CRX/DE或AEM Sites主控台，確認受影響頁面的jcr:content節點包含正確的元件。
  3. 識別預覽應用程式用來擷取內容的API端點。 此端點通常是自訂或Headless端點。 如果您不確定，請洽詢您的前端或後端團隊。
  4. 使用瀏覽器或API工具直接存取端點，並驗證JSON回應包含所有預期的選件元件。
  5. 決定預覽環境或其前端層後端是否會快取API回應。 清除快取或縮短快取存留時間，以擷取最新內容。 如果實施包含自訂快取失效邏輯，請確認該邏輯已啟用且運作正常。
  6. 對「作者」中受影響的頁面進行可識別的小型變更，例如編輯文字或重新排列元件。 記下變更時間，並監視預覽環境顯示更新的時間。
  7. 請檢閱AEM和預覽或前端對前端記錄檔，以追蹤變更傳播。
  8. 如果問題持續發生，請更新並重新發佈頁面或其jcr:content節點，以強制重新整理。
  9. 請您的前端或後端團隊檢閱整合和快取邏輯。 確認預覽應用程式呼叫正確的AEM端點，而且沒有從其快取中提供過時的內容。
  10. 確認所有選件元件皆會在「預覽」環境中出現並顯示目前內容。

相關閱讀

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