AEM创作自定义servlet页面在Experience Cloud Shell中加载旋转图标时卡住
了解如何解决在通过AEM Shell iframe访问时,Experience Cloud Author中的自定义servlet页面卡在加载旋转图标上的问题。
描述 description
从AEM Author访问自定义servlet或HTML页面时,该页面会在Experience Cloud Shell iframe中加载。 在此方案中,页面似乎卡在加载旋转图标叠加上,即使HTML内容存在于iframe中也是如此。 启用Unified Shell后,此问题可在多个用户中重现,并且Servlet代码最近没有更改。 其他URL参数(如_mr和shell_domain)会自动附加。 直接在新浏览器选项卡(在Unified Shell上下文之外)中打开同一servlet URL时,不使用旋转图标会正确呈现页面。 禁用Unified Shell或通过直接资源路径访问servlet还允许页面按预期呈现。
环境
- Adobe Experience Manager (AEM)作者
- AEM as a Cloud Service (AEMaaCS)和内部部署
症状
- 通过Experience Cloud Shell iframe访问时,自定义servlet页面仍隐藏在加载旋转图标叠加后面。
- HTML内容存在于iframe中,但不可见。
- 直接访问servlet URL(在Shell外)可按预期运行。
原因
Experience Cloud Unified Shell需要来自已加载页面的内容就绪信号来消除旋转图标叠加。 不加载标准AEM编辑器框架JavaScript的自定义servlet响应不会发送此信号,从而导致旋转图标无限期地保留。 直接访问servlet(在Shell外部)可避免此问题。
解决方法 resolution
请按照以下步骤解决问题:
- 通过Experience Cloud Shell路由访问自定义servlet(例如:
/ui#/aem/your/servlet/path)。 - 观察页面是否仍然卡在加载旋转图标叠加上,即使HTML内容存在于iframe中也是如此。
- 从浏览器的网络选项卡复制完整的servlet URL(包括任何附加的参数)。
- 直接在新浏览器选项卡中打开此URL(在Unified Shell上下文外)。
- 确认页面在无旋转图标的情况下成功呈现。
- 绕过Unified Shell,更新直接指向servlet资源路径的任何链接、书签或导航路径(例如:
/content/your/site/servlet.html)。 - 如果AEM环境的其他部分需要Unified Shell,请将这种解决方法限制为仅使用自定义servlet工作流。 确保用户通过纯链接或在单独的浏览器选项卡中访问servlet,而不是通过AEM的页面/内容树导航(这将生成Shell封装路由)访问。
- (可选)检查Servlet输出中可能依赖于
window.top、window.parent或类似结构的任何客户端代码,因为这些代码在Unified Shell iframe中的行为可能有所不同。
应用此解决方法后,用户应该能够访问自定义servlet页面,而不会遇到停滞的加载回旋。
recommendation-more-help
experience-cloud-kcs-help-kbarticles