文档Experience Cloud KCS

由于OS或依赖关系不匹配，导致AEM Dispatcher安装和升级失败

最近更新： 2026年6月22日

当Apache不启动、模块不加载或者操作系统、OpenSSL或架构更新后依赖项不匹配时，Adobe Experience Manager (AEM) Dispatcher安装或升级失败。 出现此问题的原因是Dispatcher二进制文件与系统库不兼容、模块选择不正确或在环境升级期间不支持的架构。 要解决此问题，请选择正确的二进制文件，验证依赖关系，然后调整配置。

描述 description

环境

Adobe Experience Manager as a Cloud Service (AEMaaCS)

问题/症状

  • 由于缺少libssl或libcrypto依赖项，Apache在升级后无法启动。
  • 由于架构不兼容，Dispatcher模块未正确加载或加载。
  • 在OpenSSL版本（如1.1到3.0）之间迁移时，环境显示错误。
  • 对于受支持的操作系统版本（如RHEL 8、RHEL 9或Amazon Linux 2023），系统显示不确定或不匹配。

根本原因

当Dispatcher模块与系统环境不匹配，因为它依赖于特定的CPU架构、OpenSSL版本、Apache内部版本和操作系统级别的库时，会出现问题。 当环境升级或更改时，由于依赖项不匹配、不正确的二进制选择或旧版本中不支持的体系结构（如ARM64）而导致现有模块无法加载。

解决方法 resolution

按照以下步骤识别环境并安装兼容的Dispatcher模块。

  1. 使用系统命令检查操作系统、Apache、CPU架构和OpenSSL版本，从而识别操作环境。
  2. 通过基于OpenSSL版本、OS和体系结构（如ssl1.1、ssl3.0或ARM64支持的版本）选择二进制文件来确定正确的Dispatcher包。
  3. 在服务器上下载并提取Dispatcher包，并确认提取后模块文件可用。
  4. 将Dispatcher模块文件复制到Apache模块目录，并确保该文件位于正确的位置。
  5. 使用正确的模块路径添加Dispatcher LoadModule指令来更新Apache配置。
  6. 通过检查所有必需的库是否存在并与OpenSSL版本匹配来验证模块依赖项。
  7. 重新启动Apache，并确认Dispatcher模块成功加载且没有启动错误。
  8. 升级后清除Dispatcher缓存，以确保新资源正确加载并避免陈旧内容问题。
  9. 通过运行配置检查、验证日志、发送测试请求以及确认成功的模块初始化和缓存行为来验证解决方案。

何时上报

  • 即使解决了依赖性和配置问题，Apache服务也无法启动。
  • Dispatcher模块已加载，但仍显示依赖关系或兼容性错误。
  • 目标操作系统或架构不存在所需的Dispatcher包。
  • 该环境需要不受支持的配置，例如ARM64的较旧Dispatcher版本。

相关阅读

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