文档Experience Cloud KCS

在Author中进行更新后，AEM预览环境中缺少选件组件

最近更新： 2026年8月30日

在Adobe Experience Manager (AEM)中，您在创作中添加或更新的Offer组件不会出现在“预览”环境中。 该问题通常会影响特定页面，而其他页面将继续按预期显示更新的内容。 不会显示任何错误消息，但“预览”会显示缺失或过时的选件组件，这将影响发布前的内容验证。 要解决此问题，请验证页面内容和API响应，选中预览或前端后端缓存，并重新发布受影响的页面。

描述 description

环境

  • Adobe Experience Manager (AEM)，所有版本
  • 分离/无头预览环境（例如，使用AEM API的自定义前端应用程序）

问题/症状

  • 更新的或新的选件组件在AEM创作中可见，但在“预览”环境中不可见。
  • 其他页面可能会按预期更新；此问题特定于某些页面。
  • 未显示任何显式错误消息。

原因

最常见的原因是“预览”环境或其前端后端(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