解决由于OSGi捆绑包不一致而导致的单个AEM发布实例上的HTTP 500错误
本文介绍如何解决在单个Adobe Experience Manager (AEM)发布实例上发生的HTTP 500错误,当时OSGi捆绑包在异常或不干净重新启动后无法解析和正确激活。
描述 description
环境
Adobe Experience Manager (AEM) Managed Services多实例发布部署(所有受支持的版本)
问题/症状
- 一个发布实例在多个应用程序URL中返回大量的HTTP
500错误。 - 其他发布实例继续正常提供流量。
- 应用程序日志显示重复的HTL/Sightly编译失败,因为无法解析Java类。
- OSGi框架记录报告包解析错误和所需应用程序包的未解析依赖关系。
原因
异常或不干净的重新启动使受影响的发布实例上的OSGi框架处于不一致的状态。 无法解析和激活所需的应用程序包。 因此,HTL编译所需的类不可用,对受影响应用程序URL的请求返回HTTP 500错误。
解决方法 resolution
请按照以下步骤解决问题。
-
从负载平衡器循环中删除受影响的发布实例,以防止进一步影响客户。
-
使用干净的受控进程重新启动或替换受影响的发布实例。
-
重新启动或替换实例后,验证所有必需的OSGi捆绑包均已解析并处于活动状态:
-
访问AEM系统控制台(通常在
/system/console/bundles),并检查所有捆绑包是否都处于 活动 状态。 -
确认应用程序页面成功呈现,且没有编译错误。
-
监控错误日志,了解进一步的包解析或HTL编译错误。
-
-
作为一项预防措施,在每次计划内或计划外重新启动后实施准备情况检查,以确保所有捆绑包在实例恢复服务之前处于活动状态。
recommendation-more-help
experience-cloud-kcs-help-kbarticles