解决由于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

请按照以下步骤解决问题。

  1. 从负载平衡器循环中删除受影响的发布实例,以防止进一步影响客户。

  2. 使用干净的受控进程重新启动或替换受影响的发布实例。

  3. 重新启动或替换实例后,验证所有必需的OSGi捆绑包均已解析并处于活动状态:

    • 访问AEM系统控制台(通常在/system/console/bundles),并检查所有捆绑包是否都处于 活动 状态。

    • 确认应用程序页面成功呈现,且没有编译错误。

    • 监控错误日志,了解进一步的包解析或HTL编译错误。

  4. 作为一项预防措施,在每次计划内或计划外重新启动后实施准备情况检查,以确保所有捆绑包在实例恢复服务之前处于活动状态。

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