升级JBoss至新版本后jboss-client.jar抛出NoClassDefFoundError问题咨询

错误信息 #

Exception in thread "Thread-3" java.lang.NoClassDefFoundError: org/jboss/modules/ModuleLoadException
        at org.jboss.ejb.client.EJBClientContext.getDefault(EJBClientContext.java:110)
        at org.wildfly.common.context.ContextManager.getPrivileged(ContextManager.java:286)
        at org.jboss.ejb.client.EJBClientContext.getCurrent(EJBClientContext.java:861)
        at org.jboss.ejb.client.EJBInvocationHandler.invoke(EJBInvocationHandler.java:165)
        at org.jboss.ejb.client.EJBInvocationHandler.invoke(EJBInvocationHandler.java:116)
        at com.sun.proxy.$Proxy2.sendResponse(Unknown Source)
        at java.base/java.lang.Thread.run(Thread.java:829)
Caused by: java.lang.ClassNotFoundException: org.jboss.modules.ModuleLoadException
        at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:581)
        at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178)
        at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:522)
        ... 9 more

排查提示 #

• 检查客户端依赖版本匹配：新版本JBoss对应的jboss-client.jar或相关依赖包版本必须与服务器端一致，不同版本JBoss的客户端依赖类结构存在差异，org.jboss.modules.ModuleLoadException属于JBoss Modules组件，需确保该类所在jar包已正确引入。
• 确认依赖包完整性：检查项目依赖中是否包含jboss-modules.jar（目标类所在jar包），若用Maven/Gradle构建，需验证依赖坐标的正确性，且版本与JBoss服务器版本完全匹配。
• 排查类路径配置：确认运行时类路径中包含所有必需的JBoss客户端jar包，同时清理旧版本冲突jar包，可通过java -cp命令或IDE类路径配置项检查依赖是否缺失或重复。
• 验证客户端配置文件：若使用EJB客户端，检查jboss-ejb-client.properties等配置文件是否适配新版本JBoss，部分配置项变更可能引发类加载异常。
• 清理缓存并重新构建：删除项目构建缓存目录（如Maven的target、Gradle的build），重新编译构建项目，避免旧编译产物或缓存依赖导致的问题。

内容的提问来源于stack exchange，提问作者Re Viki