使用JBoss Tools部署项目报NoClassDefFoundError问题咨询

问题场景 #

• 直接部署war文件，项目运行正常
• 手动解压war后部署，项目运行正常
• 通过JBoss Tools完成部署（已确认war解压完成），访问网页时触发NoClassDefFoundError，错误栈如下：

Caused by: java.lang.NoClassDefFoundError: gbt/osmoze/view/GuestPreferences$1
    at deployment.osmoze.war//gbt.osmoze.view.GuestPreferences.init(GuestPreferences.java:59)
    ... 81 more

使用环境：JBoss Tool 4.27.0 Final、Wildfly-25.0.1.Final、Eclipse 2023-03

可能的原因及排查方向 #

• 编译与运行环境JDK版本不匹配：GuestPreferences$1是GuestPreferences类中的匿名内部类，若Eclipse（JBoss Tools依赖）使用的编译JDK版本高于Wildfly运行时的JDK版本，会导致类字节码不兼容，无法加载。检查项目的编译JDK设置（项目属性→Java Build Path→Libraries）和Wildfly的运行JDK版本是否一致。
• JBoss Tools部署缓存残留：工具可能保留了旧的部署缓存，导致新生成的匿名内部类文件未被同步到服务器。操作步骤：
  1. 右键项目→Clean，清理Eclipse编译缓存
  2. 停止Wildfly，删除standalone/deployments下的osmoze相关部署文件，以及standalone/data/content中的对应缓存目录
  3. 重新启动Wildfly并通过JBoss Tools部署项目
• Deployment Assembly配置缺失：Eclipse的Deployment Assembly决定了哪些文件会被部署到服务器。检查项目属性→Deployment Assembly，确认编译输出目录（如target/classes）和所有依赖jar包都已被添加到部署路径中，避免类文件或依赖缺失。
• 匿名内部类编译异常：查看项目编译输出目录（默认是target/classes或bin），确认是否存在GuestPreferences$1.class文件。对比war包中的对应文件，若编译目录中缺失该文件，说明JBoss Tools的编译过程未生成该类，可尝试重新配置项目的编译器设置（项目属性→Java Compiler），确保启用匿名内部类的编译支持。

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