文档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