解决AEM Forms 6.5.2 LTS中org.apache.xpath.XPathAPI的ClassNotFoundException

本文说明如何解决在AEM Forms 6.5.2 LTS部署期间因缺少依赖关系而发生的org.apache.xpath.XPathAPI的ClassNotFoundException。

描述 description

环境

Adobe Experience Manager Forms 6.5.2 LTS(所有平台)

问题/症状

  • 在新服务器上安装AEM Forms 6.5.2 LTS后,应用程序部署失败。

  • 在全新安装中,如果不存在之前的AEM Forms安装,则会出现此问题。

  • 服务器日志包含类似于以下内容的错误:

    code language-none
    java.lang.ClassNotFoundException: org.apache.xpath.XPathAPI from [ Module "deployment.adobe-livecycle-jboss.ear.um.jar" from Service Module Loader]
    
    com.adobe.idp.common.errors.exception.IDPException: Failed to load default configuration. error:jakarta.ejb.EJBException: WFLYEJB0442: Unexpected Error
    
  • 部署失败会导致应用程序无法正确启动。

原因

用户管理模块需要xalan-2.7.2.jar依赖关系。 默认情况下,所需的JAR文件未包含在AEM Forms 6.5.2 LTS中,因此模块无法加载org.apache.xpath.XPathAPI。

解决方法 resolution

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

  1. 停止AEM Forms服务器。
  2. 导航到AEM Forms安装中的/jboss/standalone/deployments目录。
  3. 使用包管理器工具(如7zip)解压缩adobe-livecycle-jboss.ear文件。
  4. 从官方的Apache Xalan项目或其他可信来源获取xalan-2.7.2.jar文件。
  5. 将xalan-2.7.2.jar文件添加到adobe-livecycle-jboss.ear/lib目录。
  6. 关闭包管理器工具以确保保存更改。
  7. 启动服务器,然后再次执行引导步骤。
  8. 验证服务器是否启动时未出现ClassNotFoundException错误。
recommendation-more-help
experience-cloud-kcs-help-kbarticles