WildFly部署EJB与Web服务常见问题解决

本篇文章向大家介绍《WildFly部署EJB与Web服务问题解决》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

1. 理解EJB与Web服务部署中的类加载问题

在Java EE应用中，尤其是在EAR（Enterprise Archive）部署模式下，多个模块（如EJB JAR、WAR）之间的类加载和依赖管理是常见的挑战。当Web服务（WAR）尝试调用同一EAR中的EJB时，如果EJB接口类无法被Web服务的类加载器找到，就会导致NoClassDefFoundError或ClassNotFoundException。

问题现象分析：

提供的错误日志显示：

WFLYSRV0153: Failed to process phase POST_MODULE of deployment "myapp-ws.war"
    Caused by: java.lang.RuntimeException: WFLYSRV0177: Error getting reflective information for class org.ws.MyAppWSImpl with ClassLoader ModuleClassLoader for Module "deployment.myapp-ws.war" from Service Module Loader
    Caused by: java.lang.NoClassDefFoundError: Lorg/myapp/MyAppStatelessLocal;
    Caused by: java.lang.ClassNotFoundException: org.myappp.InfossStatelessLocal from [Module "deployment.myapp-ws.war" from Service Module Loader]

这个错误发生在myapp-ws.war部署的POST_MODULE阶段，表明在WildFly尝试初始化Web服务实现类org.ws.MyAppWSImpl时，无法找到其依赖的EJB接口org.myapp.MyAppStatelessLocal（根据错误堆栈中的NoClassDefFoundError）。值得注意的是，ClassNotFoundException中提到了org.myappp.InfossStatelessLocal，这可能是一个印刷错误或代码中实际引用的类名有误。在排查此类问题时，首先应仔细核对所有涉及的类名和包名，确保它们完全一致。

Maven依赖配置分析：

根据提供的pom.xml文件，myapp-app是父POM，myapp-ear将myapp-ejb（EJB模块）和myapp-ws（Web服务模块）打包在一起。myapp-ws的pom.xml中对myapp-ejb的依赖配置如下：

    ${project.groupId}
    myapp-ejb
    ejb
    provided

这里使用了scope=provided，意味着Maven在编译时需要myapp-ejb，但在运行时期望由应用服务器（WildFly）提供。在EAR部署中，当EJB模块和WAR模块都包含在同一个EAR中时，provided通常是合理的，因为EJB模块本身会被部署到EAR的根目录或lib目录，其类应由EAR的类加载器提供给其他模块。然而，WildFly的类加载器隔离机制有时可能导致模块间默认可见性不足，尤其是在复杂场景下。

2. 解决方案：明确声明模块依赖

为了解决NoClassDefFoundError，最可靠的方法是利用WildFly的jboss-deployment-structure.xml文件，在Web服务模块中明确声明对EJB模块的依赖。这会指示WildFly的类加载器，确保myapp-ws.war能够访问myapp-ejb.jar中的类。

2.1 检查并纠正类名与包名

在深入配置之前，请务必执行以下关键检查：

1. 核对EJB接口的完整类名： 确认myapp.lab.MyAppStatelessLocal（在MyAppWSImpl.java中引用）是否与EJB模块中实际定义的接口完全一致，包括包名和类名。
2. 核对错误日志中的类名： 错误信息中的org.myappp.InfossStatelessLocal与代码中的myapp.lab.MyAppStatelessLocal存在显著差异。请检查项目中是否存在对org.myappp.InfossStatelessLocal的引用，或者这是否是EJB接口的旧名称或错误名称。修正任何不一致之处是解决ClassNotFoundException的首要步骤。

假设类名和包名已确认无误，且问题确实出在类加载器的可见性上，则继续以下步骤。

2.2 使用 jboss-deployment-structure.xml 声明依赖

在myapp-ws.war项目的src/main/webapp/WEB-INF/目录下创建或修改jboss-deployment-structure.xml文件，添加对myapp-ejb模块的依赖。

示例代码：myapp-ws.war/WEB-INF/jboss-deployment-structure.xml